07 Layer 3 - IP Routing

HomeSupportResource CenterH3C Access Controllers Command References(R5228P01)-6W10207 Layer 3 - IP Routing
Table of Contents
Related Documents
01-Text
Title Size Download
01-Text 464.92 KB

Contents

Basic IP routing commands· 1

address-family ipv4· 1

address-family ipv6· 1

display ip routing-table· 2

display ip routing-table acl 5

display ip routing-table ip-address· 8

display ip routing-table prefix-list 10

display ip routing-table protocol 11

display ip routing-table statistics· 12

display ip routing-table summary· 13

display ipv6 rib nib· 14

display ipv6 route-direct nib· 16

display ipv6 routing-table· 19

display ipv6 routing-table acl 23

display ipv6 routing-table ipv6-address· 26

display ipv6 routing-table prefix-list 29

display ipv6 routing-table protocol 30

display ipv6 routing-table statistics· 31

display ipv6 routing-table summary· 32

display max-ecmp-num·· 33

display rib nib· 34

display route-direct nib· 36

fib lifetime· 38

max-ecmp-num·· 39

protocol lifetime· 40

reset ip routing-table statistics protocol 40

reset ipv6 routing-table statistics protocol 41

rib· 41

Static routing commands· 43

delete static-routes all 43

display route-static nib· 43

display route-static routing-table· 46

ip route-static· 48

ip route-static default-preference· 50

ip route-static-group· 50

prefix· 51

IPv6 static routing commands· 52

delete ipv6 static-routes all 52

display ipv6 route-static nib· 52

display ipv6 route-static routing-table· 55

ipv6 route-static· 57

ipv6 route-static default-preference· 58

RIP commands· 60

checkzero· 60

default cost 60

default-route· 61

display rip· 62

display rip database· 64

display rip graceful-restart 65

display rip interface· 66

display rip neighbor 68

display rip route· 69

filter-policy export 71

filter-policy import 72

graceful-restart 74

graceful-restart interval 74

host-route· 75

import-route· 75

maximum load-balancing· 76

network· 77

output-delay· 78

peer 78

preference· 79

reset rip process· 80

reset rip statistics· 80

rip· 80

rip authentication-mode· 81

rip default-route· 82

rip enable· 83

rip input 84

rip max-packet-length· 84

rip metricin· 85

rip metricout 85

rip mib-binding· 86

rip output 87

rip output-delay· 87

rip poison-reverse· 88

rip split-horizon· 88

rip summary-address· 89

rip version· 89

silent-interface· 90

summary· 91

timer triggered· 92

timers· 92

validate-source-address· 93

version· 94

RIPng commands· 95

checkzero· 95

default cost 95

display ripng· 96

display ripng database· 97

display ripng graceful-restart 98

display ripng interface· 99

display ripng neighbor 100

display ripng route· 101

enable ipsec-profile· 103

filter-policy export 103

filter-policy import 105

graceful-restart 106

graceful-restart interval 106

import-route· 107

maximum load-balancing· 107

output-delay· 108

preference· 109

reset ripng process· 109

reset ripng statistics· 110

ripng· 110

ripng default-route· 111

ripng enable· 111

ripng ipsec-profile· 112

ripng metricin· 113

ripng metricout 113

ripng output-delay· 114

ripng poison-reverse· 114

ripng split-horizon· 115

ripng summary-address· 115

timer triggered· 116

timers· 117

Index· 119

 


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

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

Syntax

display ip routing-table [ verbose ]

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.

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. The following route types are available:

·         DirectDirect route.

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

 

# 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

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x1000c        OrigNextHop: 127.0.0.1

      Label: NULL           RealNextHop: 127.0.0.1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A 

 

Destination: 1.1.1.0/24

   Protocol: Static

 Process ID: 0

  SubProtID: 0x0                    Age: 04h20m37s

       Cost: 0               Preference: 60

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active Adv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x1008c        OrigNextHop: 192.168.47.4

      Label: NULL           RealNextHop: 192.168.47.4

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet1/0/1

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

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

IpPre

IP precedence.

QosLocalID

Local QoS ID.

Tag

Route tag.

State

Route state:

·         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. The device does not support this state in the current software version.

·         Nat—Routes generated by NAT.

·         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. The device does not support this field in the current software version.

NibID

ID of the next hop.

LastAs

Last AS number. The device does not support this field in the current software version.

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.

FtnIndex

Index of the FTN entry.

TrafficIndex

Traffic index in the range of 1 to 64.

Connector

BGP connector attribute exchanged between BGP peers along with a VPN IPv4 route. The value of the attribute is the IP address of the remote PE device. The BGP connector attribute is used for MD VPN. The device does not support this field in the current software version.

VpnPeerId

VPN peer ID of the route, in the range of 1 to 134217727. The device does not support this field in the current software version.

Dscp

DSCP priority of the route, in the range of 0 to 63.

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

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.

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] acl basic 2000

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

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

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

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

 

Summary count : 4

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

192.168.1.0/24      Direct 0    0            192.168.1.111   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

 

Summary count : 4

 

Destination: 192.168.1.0/24

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x1                    Age: 04h20m37s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active Adv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x10080        OrigNextHop: 192.168.1.111

      Label: NULL           RealNextHop: 192.168.1.111

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet1/0/1

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: 192.168.1.0/32

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 04h20m37s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x1008c        OrigNextHop: 192.168.1.111

      Label: NULL           RealNextHop: 192.168.1.111

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet1/0/1

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: 192.168.1.111/32

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x1                    Age: 04h20m37s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x10004        OrigNextHop: 127.0.0.1

      Label: NULL           RealNextHop: 127.0.0.1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: 192.168.1.255/32

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 04h20m37s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x1008c        OrigNextHop: 192.168.1.111

      Label: NULL           RealNextHop: 192.168.1.111

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet1/0/1

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: 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 ]

display ip routing-table ip-address1 to ip-address2 [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

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

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

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 ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

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

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] ip prefix-list test permit 1.1.1.0 24

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

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

 

Summary count : 1

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

1.1.1.0/24          Direct 0    0            1.1.1.2         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

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active Adv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x2                 OrigAs: 0

      NibID: 0x10000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: 0.0.0.0

      Flags: 0x1008c        OrigNextHop: 1.1.1.2

      Label: NULL           RealNextHop: 1.1.1.2

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet1/0/2

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: 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 ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

protocol: Specifies a routing protocol. It can be direct 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 : 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        GE1/0/1

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

Views

Any view

Predefined user roles

network-admin

network-operator

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

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.

Syntax

display ip routing-table summary

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display brief routing table information for the public network.

<Sysname> display ip routing-table summary

 

Max ECMP: 4

Max Active Route: 3072

Remain Active Route: 3058

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.

 

display ipv6 rib nib

Use display ipv6 rib nib to display next hop information in the IPv6 RIB.

Syntax

display ipv6 rib nib [ self-originated ] [ nib-id ] [ verbose ]

display ipv6 rib nib protocol protocol [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

nib-id: Specifies a NIB by its ID in the range of 1 to FFFFFFFF.

verbose: Displays detailed next hop information in the IPv6 RIB. If you do not specify this keyword, the command displays brief next hop information in the IPv6 RIB.

protocol protocol: Specifies a protocol by its name, which can be direct or static.

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

   UserKey1: 0x0                Nexthop: ::

    IFIndex: 0x111            LocalAddr: ::

   TopoNthp: Invalid

 

      NibID: 0x20000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: ::1

    IFIndex: 0x112            LocalAddr: ::1

   TopoNthp: Invalid

 

...

Table 5 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. The device does not support this field in the current software version.

Nexthop

Next hop address.

IFIndex

Interface index.

LocalAddr

Local interface address.

TopoNthp

Topology to which the next hop belongs. 0 represents the base topology. The device does not support this field in the current software version.

 

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

   UserKey1: 0x0                Nexthop: ::

    IFIndex: 0x111            LocalAddr: ::

   TopoNthp: Invalid

     RefCnt: 4              FlushRefCnt: 1

       Flag: 0x84               Version: 1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: ::

  RelyDepth: 0              RealNexthop: ::

  Interface: NULL0            LocalAddr: ::

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0

 

      NibID: 0x20000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: ::1

    IFIndex: 0x112            LocalAddr: ::1

   TopoNthp: Invalid

     RefCnt: 4              FlushRefCnt: 1

       Flag: 0x84               Version: 1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: ::1

  RelyDepth: 0              RealNexthop: ::1

  Interface: InLoop0          LocalAddr: ::1

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0

 

...

Table 6 Command output

Field

Description

Policy

Tunnel policy name. The device does not support this field in the current software version.

x nexthop (s)

Number of next hops.

PrefixIndex

Prefix index of the next hop for an ECMP route.

Vrf

VPN name. The device does not support this field in the current software version.

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.

Topology

Topology name. base represents the base topology. The device does not support this field in the current software version.

Weight

Weight of the ECMP route. The route is not an ECMP route if its weight is 0.

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

   UserKey1: 0x0                Nexthop: ::

    IFIndex: 0x111            LocalAddr: ::

   TopoNthp: Invalid

 

      NibID: 0x20000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: ::1

    IFIndex: 0x112            LocalAddr: ::1

   TopoNthp: Invalid

 

...

Table 7 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. The device does not support this field in the current software version.

Nexthop

Next hop address.

IFIndex

Interface index.

LocalAddr

Local interface address.

TopoNthp

Topology to which the next hop belongs. 0 represents the base topology. The device does not support this field in the current software version.

 

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

   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: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0

 

      NibID: 0x20000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   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: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0

 

...

Table 8 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. The device does not support this field in the current software version.

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.

Topology

Topology name. The device does not support this field in the current software version.

Weight

Weight of the ECMP route. The route is not an ECMP route if its weight is 0.

 

display ipv6 routing-table

Use display ipv6 routing-table to display IPv6 routing table information.

Syntax

display ipv6 routing-table [ verbose ]

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.

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 9 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. The following route types are available:

·         DirectDirect route.

·         StaticStatic route.

Cost

Cost of the route.

 

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

<Sysname> display ipv6 routing-table verbose

 

Destinations : 6 Routes : 6

 

Destination: ::1/128

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 19h23m02s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10004        OrigNextHop: ::1

      Label: NULL           RealNextHop: ::1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: 12::/96

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 00h01m47s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active Adv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10080        OrigNextHop: ::

      Label: NULL           RealNextHop: ::

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet2/0/2

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: 12::1/128

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 00h01m45s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10004        OrigNextHop: ::1

      Label: NULL           RealNextHop: ::1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: FE80::/10

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 19h23m02s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000002          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10084        OrigNextHop: ::

      Label: NULL           RealNextHop: ::

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

 

Destination: FF00::/8

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 19h23m02s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

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

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A              VpnPeerId: N/A

       Dscp: N/A

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

IpPre

IP precedence.

QosLocalID

Local QoS ID.

Tag

Tag of the route.

State

Route state:

·         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. The device does not support this state in the current software version.

·         Nat—Routes generated by NAT.

·         TunE—Tunnel.

OrigTblID

Original routing table ID.

OrigVrf

Original VPN that the route belongs to. The device does not support this field in the current software version.

TableID

ID of the routing table.

OrigAs

Original AS number. The device does not support this field in the current software version.

NibID

ID of the next hop.

LastAs

Last AS number. The device does not support this field in the current software version.

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.

FtnIndex

Index of the FTN entry.

TrafficIndex

Traffic index in the range of 1 to 64.

Connector

BGP connector attribute exchanged between BGP peers along with a VPN IPv4 route. The value of the attribute is the IP address of the remote PE device. The BGP connector attribute is used for MD VPN. The device does not support this field in the current software version.

VpnPeerId

ID of the VPN peer to which the route belongs, in the range of 1 to 134217727. This field displays N/A when the value is invalid. The device does not support this field in the current software version.

Dscp

DSCP value of the route, in the range of 0 to 63. This field displays N/A when the value is invalid.

Summary count

Number of routes.

 

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

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.

Usage guidelines

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

Examples

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

<Sysname> display ipv6 routing-table acl 2000

 

Summary count : 6

 

Destination : ::1/128                                    Protocol  : Direct

NextHop     : ::1                                        Preference: 0

Interface   : InLoop0                                    Cost      : 0

 

Destination: 12::/96                                     Protocol  : Direct

NextHop    : ::                                          Preference: 0

Interface  : GE2/0/2                                     Cost      : 0

 

Destination: 12::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

For command output, see Table 9.

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

<Sysname> display ipv6 routing-table acl 2000 verbose

 

Summary count : 6

 

Destination: ::1/128

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 19h29m12s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10004        OrigNextHop: ::1

      Label: NULL           RealNextHop: ::1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A

 

Destination: 12::/96

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 00h07m57s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active Adv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000003          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10080        OrigNextHop: ::

      Label: NULL           RealNextHop: ::

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet2/0/2

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A

 

Destination: 12::1/128

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 00h07m55s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10004        OrigNextHop: ::1

      Label: NULL           RealNextHop: ::1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A

 

Destination: FE80::/10

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 19h29m12s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000002          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10084        OrigNextHop: ::

      Label: NULL           RealNextHop: ::

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A

 

Destination: FF00::/8

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x0                    Age: 19h29m12s

       Cost: 0               Preference: 0

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000001          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10014        OrigNextHop: ::

      Label: NULL           RealNextHop: ::

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: NULL0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0             TrafficIndex: N/A

  Connector: N/A

For command output, see Table 10.

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 ]

display ipv6 routing-table ipv6-address1 to ipv6-address2 [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ipv6-address: Specifies a destination IPv6 address.

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

longer-match: Displays the route 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

# Display detailed information about the routes to destination IPv6 addresses 1:2::3:4/128.

<Sysname> display ipv6 routing-table 1:2::3:4 128 verbose

 

Summary count : 1

 

Destination: 1:2::3:4/128

   Protocol: Direct

 Process ID: 0

  SubProtID: 0x1                    Age: 00h01m14s

       Cost: 0               Preference: 255

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active Adv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0x1                 OrigAs: 0

      NibID: 0x26000000          LastAs: 0

     AttrID: 0x0               Neighbor: 2:2::3:4

      Flags: 0x10060        OrigNextHop: 2:2::3:4

      Label: NULL           RealNextHop: 2:2::3:4

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: GigabitEthernet1/0/1

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A

For command output, see Table 9.

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 ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

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

Usage guidelines

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

Examples

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

<Sysname> system-view

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

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

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

 

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

# 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

      IpPre: N/A             QosLocalID: N/A

        Tag: 0                    State: Active NoAdv

  OrigTblID: 0x0                OrigVrf: default-vrf

    TableID: 0xa                 OrigAs: 0

      NibID: 0x20000000          LastAs: 0

     AttrID: 0xffffffff        Neighbor: ::

      Flags: 0x10004        OrigNextHop: ::1

      Label: NULL           RealNextHop: ::1

    BkLabel: NULL             BkNextHop: N/A

  Tunnel ID: Invalid          Interface: InLoopBack0

BkTunnel ID: Invalid        BkInterface: N/A

   FtnIndex: 0x0           TrafficIndex: N/A

  Connector: N/A

For command output, see Table 10.

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 ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

protocol: Specifies a routing protocol. It can be direct 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 9.

display ipv6 routing-table statistics

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

Syntax

display ipv6 routing-table statistics

Views

Any view

Predefined user roles

network-admin

network-operator

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

Total      8           8           8           0

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

Syntax

display ipv6 routing-table summary

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

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

<Sysname> display ipv6 routing-table summary

 

Max ECMP: 4

Max Active Route: 3072

Remain Active Route: 3058

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

 

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

Usage guidelines

The following matrix shows the command and hardware compatibility:

 

Hardware series

Model

Command compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

Yes

WX3800H series

WX3820H

WX3840H

No

WX5800H series

WX5860H

No

 

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

Use display rib nib to display next hop information in the RIB.

Syntax

display rib nib [ self-originated ] [ nib-id ] [ verbose ]

display rib nib protocol protocol [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

nib-id: Specifies a NIB by its ID in the range of 1 to FFFFFFFF.

verbose: Displays detailed next hop information in the RIB. If you do not specify this keyword, the command displays brief next hop information in the RIB.

protocol protocol: Specifies a protocol by its name, which can be direct 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: 0

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

   TopoNthp: 0

 

      NibID: 0x10000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 127.0.0.1

    IFIndex: 0x112            LocalAddr: 127.0.0.1

   TopoNthp: 0

 

      NibID: 0x10000002        Sequence: 2

       Type: 0x5                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 127.0.0.1

    IFIndex: 0x112            LocalAddr: 127.0.0.1

   TopoNthp: 0

 

      NibID: 0x16000000        Sequence: 3

       Type: 0x21               Flushed: No

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 12.1.1.2

    IFIndex: 0x0              LocalAddr: 0.0.0.0

   TopoNthp: 0

   Instance: abc

 

...

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

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

   TopoNthp: 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: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 0

 

      NibID: 0x10000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 127.0.0.1

    IFIndex: 0x112            LocalAddr: 127.0.0.1

   TopoNthp: 0

     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: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 0

 

      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

   TopoNthp: 0

   Instance: default

     RefCnt: 9              FlushRefCnt: 3

       Flag: 0x84               Version: 1

     Policy: tnl-policy1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 22.22.22.22

  RelyDepth: 1              RealNexthop: 13.1.1.2

  Interface: GE0/1/3          LocalAddr: 13.1.1.1

  TunnelCnt: 1                      Vrf: default-vrf

   TunnelID: 1025               Topology: base

     Weight: 0

 

...

For command output, see Table 5 and Table 6.

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

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

   TopoNthp: 0

 

      NibID: 0x10000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 127.0.0.1

    IFIndex: 0x112            LocalAddr: 127.0.0.1

   TopoNthp: 0

 

...

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.

VrfNthp

VPN to which the next hop belongs. The device does not support this field in the current software version.

Nexthop

Next hop address.

IFIndex

Interface index.

LocalAddr

Local interface IP address.

TopoNthp

Topology to which the next hop belongs. 0 represents the base topology. The device does not support this field in the current software version.

 

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

   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: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 0

 

      NibID: 0x10000001        Sequence: 1

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   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: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 0

...

Table 15 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. The device does not support this field in the current software version.

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.

Topology

Topology name. base represents the base topology. The device does not support this field in the current software version.

Weight

Weight of the ECMP route. The route is not an ECMP route if its weight is 0.

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

Parameters

seconds: Specifies the maximum lifetime for routes in the FIB, in the range of 0 to 6000 seconds. When this argument is set to 0, FIB entries immediately age out after a protocol or RIB process switchover.

Usage guidelines

When a protocol or RIB process switchover occurs, 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 4.

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

The following matrix shows the command and hardware compatibility:

 

Hardware series

Model

Command compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

Yes

WX3800H series

WX3820H

WX3840H

No

WX5800H series

WX5860H

No

 

Examples

# Set the maximum number of ECMP routes to 4.

<Sysname> system-view

[Sysname] max-ecmp-num 4

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

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

Parameters

protocol: Specifies a routing protocol. It can be direct or static.

seconds: Specifies the maximum lifetime for routes and labels in the RIB, in the range of 1 to 6000 seconds.

Examples

# Set the maximum lifetime for direct routes and labels in the RIB to 60 seconds.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

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

Views

User view

Predefined user roles

network-admin

Parameters

protocol: Clears route statistics for a routing protocol. It can be direct 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 { protocol | all }

Views

User view

Predefined user roles

network-admin

Parameters

protocol: Clears route statistics for an IPv6 routing protocol. It can be direct 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

Examples

# Enter RIB view.

<Sysname> system-view

[Sysname] rib

[Sysname-rib]

 


Static routing commands

delete static-routes all

Use delete static-routes all to delete all static routes.

Syntax

delete static-routes all

Views

System view

Predefined user roles

network-admin

Usage guidelines

When you use this command, the system will prompt you to confirm the operation before deleting all the static routes.

To delete one static route, use the undo ip route-static command. To delete all static routes, including the default route, use the delete static-routes all command.

Examples

# Delete all static routes.

<Sysname> system-view

[Sysname] delete static-routes all

This will erase all IPv4 static routes and their configurations, you must reconfigure all static routes.

Are you sure?[Y/N]:y

Related commands

ip route-static

display route-static nib

Use display route-static nib to display static route next hop information.

Syntax

display route-static 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 static route next hop information. If you do not specify this keyword, the command displays brief static route next hop information.

Examples

# Displays brief static route next hop information.

<Sysname> display route-static nib

Total number of nexthop(s): 44

 

      NibID: 0x11000000        Sequence: 0

       Type: 0x21               Flushed: Yes

   UserKey0: 0x111              VrfNthp: 0

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

   TopoNthp: 0

 

      NibID: 0x11000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 5

   UserKey1: 0x0                Nexthop: 2.2.2.2

    IFIndex: 0x0              LocalAddr: 0.0.0.0

   TopoNthp: 0

 

...

Table 16 Command output

Field

Description

NibID

ID of the NIB.

NibSeq

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 instance to which the next hop belongs. The device does not support this field in the current software version.

Nexthop

Next hop address.

IFIndex

Interface index

LocalAddr

Local interface address.

TopoNthp

Topology to which the next hop belongs. 0 indicates the base topology. The device does not support this field in the current software version.

 

# Displays detailed static route next hop information.

<Sysname> display route-static nib verbose

Total number of nexthop(s): 44

 

      NibID: 0x11000000        Sequence: 0

       Type: 0x21               Flushed: Yes

   UserKey0: 0x111              VrfNthp: 0

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

   TopoNthp: 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: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 100000

 

      NibID: 0x11000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 5

   UserKey1: 0x0                Nexthop: 2.2.2.2

    IFIndex: 0x0              LocalAddr: 0.0.0.0

   TopoNthp: 0

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

 2 nexthop(s):

PrefixIndex: 0              OrigNexthop: 2.2.2.2

  RelyDepth: 7              RealNexthop: 8.8.8.8

  Interface: Dia0             LocalAddr: 12.12.12.12

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology: base

PrefixIndex: 0              OrigNexthop: 2.2.2.2

  RelyDepth: 9              RealNexthop: 0.0.0.0

  Interface: NULL0            LocalAddr: 0.0.0.0

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 100000

 

...

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

RelyDepth

Recursion depth.

RealNexthop

Real next hop.

Interface

Output interface.

localAddr

Local interface address.

TunnelCnt

Number of tunnels after route recursion.

Vrf

VPN instance name. The device does not support this field in the current software version.

TunnelID

ID of the tunnel after route recursion.

Topology

Name of the topology. base indicates the base topology. The device does not support this field in the current software version.

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.

Weight

Weight of the ECMP route. A route is not an ECMP route if its weight is 0.

 

display route-static routing-table

Use display route-static routing-table to display static routing table information.

Syntax

display route-static routing-table [ ip-address { mask-length | mask } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

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

mask: Specifies the subnet mask in dotted decimal notation.

Examples

# Display static routing table information.

<Sysname> display route-static routing-table

Total number of routes: 24

 

Status: * - valid

 

*Destination: 0.0.0.0/0

       NibID: 0x1100000a         NextHop: 2.2.2.10

   MainNibID: N/A              BkNextHop: N/A

     BkNibID: N/A              Interface: N/A

     TableID: 0x2            BkInterface: N/A

        Flag: 0x82d01           BfdSrcIp: N/A

     DbIndex: 0xd             BfdIfIndex: 0x0

        Type: Normal         BfdVrfIndex: 0

  TrackIndex: 0xffffffff           Label: NULL

  Preference: 60             vrfIndexDst: 0

     BfdMode: N/A             vrfIndexNH: 0

   Permanent: 0                      Tag: 0

 

 Destination: 0.0.0.0/0

       NibID: 0x1100000b         NextHop: 2.2.2.11

   MainNibID: N/A              BkNextHop: N/A

     BkNibID: N/A              Interface: N/A

     TableID: 0x2            BkInterface: N/A

        Flag: 0x82d01           BfdSrcIp: N/A

     DbIndex: 0xd             BfdIfIndex: 0x0

        Type: Normal         BfdVrfIndex: 0

  TrackIndex: 0xffffffff           Label: NULL

  Preference: 60             vrfIndexDst: 0

     BfdMode: N/A             vrfIndexNH: 0

   Permanent: 0                      Tag: 0

 

...

# Display information about the static route with destination address 1.2.3.4/32.

<Sysname> display route-static routing-table 1.2.3.4 32

 

*Destination: 1.2.3.4/32

       NibID: 0x11000017         NextHop: 4.4.4.4

   MainNibID: 0x11000015       BkNextHop: 5.5.5.5

     BkNibID: 0x11000016       Interface: GigabitEthernet1/0/1

     TableID: 0x2            BkInterface: GigabitEthernet1/0/2

        Flag: 0xa8d0b           BfdSrcIp: N/A

     DbIndex: 0x17            BfdIfIndex: 0x0

        Type: Normal         BfdVrfIndex: 0

  TrackIndex: 0xffffffff           Label: NULL

  Preference: 60             vrfIndexDst: 0

     BfdMode: N/A             vrfIndexNH: 0

   Permanent: 0                      Tag: 0

Table 18 Command output

Field

Description

destination

Destination address/prefix.

NibID

ID of the NIB.

MainNibID

ID of the primary next hop for static route FRR.

BkNibID

ID of the backup next hop for static route FRR.

NextHop

Next hop address.

BkNextHop

Backup next hop address.

Interface

Output interface of the route.

BkInterface

Backup output interface.

TableID

ID of the table to which the route belongs.

Flag

Flag of the route.

DbIndex

Index of the database to which the route belongs.

Type

Route type:

·         Normal.

·         DHCP.

·         NAT.

·         IPsec.

BfdSrcIp

Source IP address of the indirect BFD session. The device does not support this field in the current software version.

BfdIfIndex

Index of the interface where BFD is enabled. The device does not support this field in the current software version.

BfdVrfIndex

Index of the VPN instance where BFD is enabled. The device does not support this field in the current software version.

BfdMode

BFD session mode:

·         N/A—No BFD session is configured.

·         Ctrl—Control packet mode

·         EchoEcho packet mode.

The device does not support this field in the current software version.

TrackIndex

NQA Track index.

vrfIndexDst

Index of the destination VPN. The device does not support this field in the current software version.

vrfIndexNH

Index of the VPN to which the next hop belongs. The device does not support this field in the current software version.

Permanent

Permanent static route flag. 1 indicates a permanent static route.

 

ip route-static

Use ip route-static to configure a static route.

Use undo ip route-static to delete a static route.

Syntax

ip route-static { dest-address { mask-length | mask } | group group-name } { interface-type interface-number [ next-hop-address ] | next-hop-address [ permanent | track track-entry-number ] } [ preference preference-value ] [ tag tag-value ] [ description description-text ]

undo ip route-static { dest-address { mask-length | mask } | group group-name } [ interface-type interface-number [ next-hop-address ] | next-hop-address ] [ preference preference-value ]

Default

No static route is configured.

Views

System view

Predefined user roles

network-admin

Parameters

dest-address: Specifies the destination IP address of the static route, in dotted decimal notation.

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

mask: Specifies the subnet mask in dotted decimal notation.

group group-name: Specifies a static route group by its name, a case-sensitive string of 1 to 31 characters. If the static route group does not exist or the static route group does not contain a prefix, no static route is configured.

interface-type interface-number: Specifies an output interface by its type and number. For more information, see Layer 3—IP Routing Configuration Guide.

next-hop-address: Specifies the IP address of the next hop, in dotted decimal notation. For more information, see Layer 3—IP Routing Configuration Guide.

permanent: Specifies the route as a permanent static route. If the output interface is down, the permanent static route is still active.

track track-entry-number: Associates the static route with a track entry specified by its number in the range of 1 to 1024. For more information about Track, see High Availability Configuration Guide.

preference preference-value: Specifies a preference for the static route, in the range of 1 to 255. The default is 60.

tag tag-value: Sets a tag value for marking the static route, in the range of 1 to 4294967295. The default is 0. Tags of routes are used for route control.

description description-text: Configures a description of 1 to 60 characters for the static route. The description can include special characters, such as the space, except the question mark (?).

Usage guidelines

If the destination IP address and the mask are both 0.0.0.0 (or 0), the configured route is a default route. The default route is used for forwarding a packet matching no entry in the routing table.

Follow these guidelines when you specify the output interface or the next hop address of the static route:

·          If the output interface is a Null 0 interface, no next hop address is required.

·          If the output interface is a point-to-point interface, you can specify only the output interface. You do not need to change the configuration of the route even if the peer address is changed.

·          If the output interface is a broadcast interface that might have multiple next hops, you must specify the next hop address at the same time. Broadcast interfaces include Ethernet interfaces and VLAN interfaces.

If you specify a static route group, all prefixes in the static route group will be assigned the next hop and output interface specified by using this command.

Examples

# Configure a static route, whose destination address is 1.1.1.1/24, next hop address is 2.2.2.2, tag value is 45, and description information is for internet.

<Sysname> system-view

[Sysname] ip route-static 1.1.1.1 24 2.2.2.2 tag 45 description for internet

Related commands

·          display ip routing-table protocol

·          ip route-static-group

·          prefix

ip route-static default-preference

Use ip route-static default-preference to configure a default preference for static routes.

Use undo ip route-static default-preference to restore the default.

Syntax

ip route-static default-preference default-preference-value

undo ip route-static default-preference

Default

The default preference of static routes is 60.

Views

System view

Predefined user roles

network-admin

Parameters

default-preference-value: Specifies a default preference for static routes, in the range of 1 to 255.

Usage guidelines

If no preference is specified for a static route, the default preference applies.

When the default preference is reconfigured, it applies only to newly added static routes.

Examples

# Set a default preference of 120 for static routes.

<Sysname> system-view

[Sysname] ip route-static default-preference 120

Related commands

display ip routing-table protocol

ip route-static-group

Use ip route-static-group to create a static route group and enter static route group view.

Use undo ip route-static-group to delete the static route group.

Syntax

ip route-static-group group-name

undo ip route-static-group group-name

Default

No static route group is created.

Views

System view

Predefined user roles

network-admin

Parameters

group-name: Specifies the static route group name, a case-sensitive string of 1 to 31 characters.

Parameters

Execute the ip route-static command to configure static routes in batches after you create a static route group with static route prefixes.

Examples

# Create the static route group test.

<Sysname> system-view

[Sysname] ip route-static-group test

[Sysname-route-static-group-test]

Related commands

·          ip route-static

·          prefix

prefix

Use prefix to configure a static route prefix.

Use undo prefix to delete the static route prefix.

Syntax

prefix dest-address { mask-length | mask }

undo prefix dest-address { mask-length | mask }

Default

No static route prefix is configured.

Views

Static route group view

Predefined user roles

network-admin

Parameters

dest-address: Specifies the destination IP address of the static route, in dotted decimal notation.

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

mask: Specifies the subnet mask in dotted decimal notation.

Usage guidelines

Execute the prefix command repeatedly to add multiple static route prefixes to a static route group.

After you create a static route group with static route prefixes, execute the ip route-static command to configure static routes with the prefixes. To configure more static routes, you only need to add new static route prefixes to the group.

Examples

# Configure the static route prefix 1.1.1.1/32 for the static route group test.

<Sysname> system-view

[Sysname] ip route-static-group test

[Sysname-route-static-group-test] prefix 1.1.1.1 32

Related commands

·          ip route-static

·          ip route-static-group


IPv6 static routing commands

delete ipv6 static-routes all

Use delete ipv6 static-routes all to delete all IPv6 static routes.

Syntax

delete ipv6 static-routes all

Views

System view

Predefined user roles

network-admin

Usage guidelines

When you use this command, the system will prompt you to confirm the operation before deleting all the IPv6 static routes.

Examples

# Delete all IPv6 static routes.

<Sysname> system-view

[Sysname] delete ipv6 static-routes all

This will erase all IPv6 static routes and their configurations, you must reconfigure all static routes.

Are you sure?[Y/N]:y

Related commands

ipv6 route-static

display ipv6 route-static nib

Use display ipv6 route-static nib to display IPv6 static route next hop information.

Syntax

display ipv6 route-static 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 IPv6 static route next hop information. If you do not specify this keyword, the command displays brief IPv6 static route next hop information.

Examples

# Display brief IPv6 static route next hop information.

<Sysname> display ipv6 route-static nib

Total number of nexthop(s): 35

 

      NibID: 0x21000000        Sequence: 0

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 2::3

    IFIndex: 0x0              LocalAddr: ::

   TopoNthp: Invalid

 

      NibID: 0x21000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 3::4

    IFIndex: 0x0              LocalAddr: ::

   TopoNthp: Invalid

 

...

Table 19 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 instance to which the next hop belongs. The device does not support this field in the current software version.

Nexthop

Next hop address.

IFIndex

Interface index

LocalAddr

Local interface address.

TopoNthp

Topology to which the next hop belongs. The device does not support this field in the current software version.

 

# Display detailed IPv6 static route next hop information.

<Sysname> display ipv6 route-static nib verbose

Total number of nexthop(s): 35

 

      NibID: 0x21000000        Sequence: 0

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 2::3

    IFIndex: 0x0              LocalAddr: ::

   TopoNthp: Invalid

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 2::3

  RelyDepth: 2              RealNexthop: 2::3

  Interface: NULL0            LocalAddr: ::

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0

 

      NibID: 0x21000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 3::4

    IFIndex: 0x0              LocalAddr: ::

   TopoNthp: Invalid

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 3::4

  RelyDepth: 1              RealNexthop: 3::4

  Interface: NULL0            LocalAddr: ::

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0

 

...

Table 20 Command output

Field

Description

x nexthop(s)

Number of next hops.

Tnl-Policy

Tunnel policy. The device does not support this field in the current software version.

PrefixIndex

Prefix index of the next hop for an ECMP route.

Vrf

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

Topology

Topology name. The device does not support this field in the current software version.

Weight

Weight of the ECMP route. The route is not an ECMP route if its weight is 0.

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 route-static routing-table

Use display ipv6 route-static routing-table to display IPv6 static routing table information.

Syntax

display ipv6 route-static routing-table [ ipv6-address prefix-length ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ipv6-address: Specifies the destination IPv6 address.

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

Examples

# Display IPv6 static routing table information.

<Sysname> display ipv6 route-static routing-table

Total number of routes: 5

 

Status: * - valid

 

*Destination: 1::1/128

       NibID: 0x21000000        NextHop: 2::2

   MainNibID: N/A             BkNextHop: N/A

     BkNibID: N/A             Interface: GigabitEthernet1/0/1

     TableID: 0xa           BkInterface: N/A

        Flag: 0x80d0a          BfdSrcIp: N/A

     DbIndex: 0x3            BfdIfIndex: 0x0

        Type: Normal        BfdVrfIndex: 0

  TrackIndex: 0xffffffff          Label: NULL

  Preference: 60            vrfIndexDst: 0

     BfdMode: N/A            vrfIndexNH: 0

   Permanent: 0                     Tag: 0

 

*Destination: 1::1234/128

      NibID: 0x21000000        NextHop: 2::2

   MainNibID: N/A             BkNextHop: N/A

     BkNibID: N/A             Interface: NULL0

     TableID: 0xa           BkInterface: N/A

        Flag: 0x80d0a          BfdSrcIp: N/A

     DbIndex: 0x1            BfdIfIndex: 0x0

        Type: Normal        BfdVrfIndex: 0

  TrackIndex: 0xffffffff          Label: NULL

  Preference: 60            vrfIndexDst: 0

     BfdMode: N/A            vrfIndexNH: 0

   Permanent: 0                     Tag: 0

 

...

# Display information about the IPv6 static route with destination IPv6 address 1::1/128.

<Sysname> display ipv6 route-static routing-table 1::1 128

 

*Destination: 1::1/128

       NibID: 0x21000001        NextHop: 2::2

   MainNibID: N/A             BkNextHop: N/A

     BkNibID: N/A             Interface: GigabitEthernet1/0/1

     TableID: 0xa           BkInterface: N/A

        Flag: 0x80d0b          BfdSrcIp: N/A

     DbIndex: 0x2            BfdIfIndex: 0x0

        Type: Normal        BfdVrfIndex: 0

  TrackIndex: 0xffffffff          Label: NULL

  Preference: 60            vrfIndexDst: 0

     BfdMode: N/A            vrfIndexNH: 0

   Permanent: 0                     Tag: 429496729

Table 21 Command output

Field

Description

Destination

Destination address/prefix.

NibID

ID of the NIB.

MainNibID

ID of the primary next hop for static route FRR.

BkNibID

ID of the backup next hop for static route FRR.

NextHop

Next hop address.

BkNextHop

Backup next hop address.

Interface

Output interface of the route.

BkInterface

Backup output interface.

TableID

ID of the table to which the route belongs.

DbIndex

Index of the database to which the route belongs.

Type

Route type:

·         Normal.

·         DHCP.

·         NAT.

BfdSrcIp

Source IPv6 address of the indirect BFD session. The device does not support this field in the current software version.

BfdIfIndex

Index of the interface where BFD is enabled. The device does not support this field in the current software version.

BfdVrfIndex

Index of the VPN instance where BFD is enabled. The device does not support this field in the current software version.

BfdMode

BFD session mode:

·         N/ANo BFD session is configured.

·         CtrlControl packet mode.

·         EchoEcho packet mode.

The device does not support this field in the current software version.

TrackIndex

NQA Track index.

vrfIndexDst

Index of the destination VPN. The device does not support this field in the current software version.

vrfIndexNH

Index of the VPN to which the next hop belongs. The device does not support this field in the current software version.

Permanent

Permanent static route flag. 1 indicates a permanent static route.

 

ipv6 route-static

Use ipv6 route-static to configure an IPv6 static route.

Use undo ipv6 route-static to remove an IPv6 static route.

Syntax

ipv6 route-static ipv6-address prefix-length { interface-type interface-number [ next-hop-address ] | next-hop-address [ permanent ] } [ preference preference-value ] [ tag tag-value ] [ description description-text ]

undo ipv6 route-static ipv6-address prefix-length [ interface-type interface-number [ next-hop-address ] | next-hop-address ] [ preference preference-value ]

Default

No IPv6 static route is configured.

Views

System view

Predefined user roles

network-admin

Parameters

ipv6-address prefix-length: Specifies the IPv6 address and prefix length.

interface-type interface-number: Specifies an output interface by its type and number. If the output interface is not a point-to-point (P2P) interface, the next hop address must be specified. Non-P2P interfaces include Ethernet interfaces and VLAN interfaces.

next-hop-address: Specifies the next hop IPv6 address.

permanent: Specifies the IPv6 route as a permanent IPv6 static route. If the output interface is down, the permanent IPv6 static route is still active. Support for this keyword depends on the device model.

preference preference-value: Specifies a preference for IPv6 static routes, in the range of 1 to 255. The default is 60.

tag tag-value: Sets a tag for marking the static route, in the range of 1 to 4294967295. The default is 0. Tags of routes are used for route control.

description description-text: Configures a description for the IPv6 static route, which consists of 1 to 60 characters, including special characters such as the space, but excluding the question mark (?).

Usage guidelines

An IPv6 static route that has the destination address configured as ::/0 (a prefix length of 0) is the default IPv6 route. If the destination address of an IPv6 packet does not match any entry in the routing table, this default route is used to forward the packet.

If the output interface is a broadcast interface, the next hop address must be specified. Broadcast interfaces include Ethernet interfaces and VLAN interfaces.

Examples

# Configure an IPv6 static route, with the destination address 1:1:2::/64 and next hop 1:1:3::1.

<Sysname> system-view

[Sysname] ipv6 route-static 1:1:2:: 64 1:1:3::1

Related commands

display ipv6 routing-table protocol

ipv6 route-static default-preference

Use ipv6 route-static default-preference to set a default preference for IPv6 static routes.

Use undo ipv6 route-static default-preference to restore the default.

Syntax

ipv6 route-static default-preference default-preference-value

undo ipv6 route-static default-preference

Default

The default preference of IPv6 static routes is 60.

Views

System view

Predefined user roles

network-admin

Parameters

default-preference-value: Specifies a default preference for IPv6 static routes, in the range of 1 to 255.

Usage guidelines

If no preference is specified for an IPv6 static route, the default preference applies.

When the default preference is reconfigured, it applies only to newly added IPv6 static routes.

Examples

# Set a default preference of 120 for IPv6 static routes.

<Sysname> system-view

[Sysname] ipv6 route-static default-preference 120

Related commands

display ipv6 routing-table protocol


RIP commands

The following compatibility matrix shows the support of hardware platforms for RIP:

 

Hardware series

Model

Command compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

Yes

WX3800H series

WX3820H

WX3840H

No

WX5800H series

WX5860H

No

 

checkzero

Use checkzero to enable zero field check on RIPv1 messages.

Use undo checkzero to disable zero field check.

Syntax

checkzero

undo checkzero

Default

The zero field check feature is enabled.

Views

RIP view

Predefined user roles

network-admin

Usage guidelines

When the zero field check is enabled, the router discards RIPv1 messages in which zero fields contain non-zero values. If all messages are trustworthy, disable this feature to reduce the workload of the CPU.

Examples

# Disable zero field check on RIPv1 messages for RIP process 1.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1] undo checkzero

default cost

Use default cost to configure a default metric for redistributed routes.

Use undo default cost to restore the default.

Syntax

default cost cost-value

undo default cost

Default

The default metric of redistributed routes is 0.

Views

RIP view

Predefined user roles

network-admin

Parameters

cost-value: Specifies a default metric for redistributed routes, in the range of 0 to 16.

Usage guidelines

When you use the import-route command to redistribute routes from another routing protocol without specifying a metric, the metric specified by the default cost command applies.

Examples

# Configure a default metric of 3 for redistributed routes.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] default cost 3

Related commands

import-route

default-route

Use default-route to configure all interfaces running a RIP process to advertise a default route with a specified metric to RIP neighbors.

Use undo default-route to restore the default.

Syntax

default-route { only | originate } [ cost cost-value ]

undo default-route

Default

No default route is sent to RIP neighbors.

Views

RIP view

Predefined user roles

network-admin

Parameters

only: Advertises only a default route.

originate: Advertises both a default route and other routes.

cost-value: Specifies a cost for the default route, in the range of 1 to 15. The default is 1.

Usage guidelines

A RIP router configured with this feature does not receive any default route from RIP neighbors.

Examples

# Configure all interfaces running RIP process 100 to send only a default route with a metric of 2 to RIP neighbors.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] default-route only cost 2

Related commands

rip default-route

display rip

Use display rip to display state and configuration information for a RIP process.

Syntax

display rip [ process-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535. If no process is specified, the command displays state and configuration information for all RIP processes.

Examples

# Display current state and configuration information for all RIP processes.

<Sysname> display rip

  Public VPN-instance name:

    RIP process: 1

       RIP version: 1

       Preference: 100

           Routing policy: abc

       Fast-reroute:

           Routing policy: frr

       Checkzero: Enabled

       Default cost: 0

       Summary: Enabled

       Host routes: Enabled

       Maximum number of load balanced routes: 8

       Update time   :   30 secs  Timeout time         :  180 secs

       Suppress time :  120 secs  Garbage-collect time :  120 secs

       Update output delay:   20(ms)  Output count:    3

       TRIP retransmit time:    5(s)  Retransmit count: 36

       Graceful-restart interval:   60 secs

       Triggered Interval : 5 50 200

       BFD: Enabled (ctrl)

       Silent interfaces: None

       Default routes: Originate  Default routes cost: 3

       Verify-source: Enabled

       Networks:

           1.0.0.0

       Configured peers:

           197.168.6.2

       Triggered updates sent: 0

       Number of routes changes: 1

       Number of replies to queries: 0

Table 22 Command output

Field

Description

Public VPN-instance name/Private VPN-instance name

This field is not supported in the current software version.

Public network or VPN where the RIP process runs.

RIP process

RIP process ID.

RIP version

RIP version 1 or 2.

Preference

RIP preference.

Checkzero

Indicates whether the zero field check is enabled for RIPv1 messages: Enabled or Disabled.

Default cost

Default cost of redistributed routes.

Summary

Indicates whether route summarization is enabled: Enabled or Disabled.

Host routes

Indicates whether to receive host routes: Enabled or Disabled.

Update time

RIP update interval, in seconds.

Timeout time

RIP timeout time, in seconds.

Suppress time

RIP suppress interval, in seconds.

Garbage-collect time

RIP garbage-collection interval, in seconds.

Update output delay

RIP packet sending interval, in seconds.

Output count

Maximum number of RIP packets sent at each interval.

TRIP retransmit time

This field is not supported in the current software version.

TRIP message retransmission interval, in seconds.

Retransmit count

This field is not supported in the current software version.

Retransmission times of TRIP messages.

Graceful-restart interval

GR interval, in seconds.

Triggered Interval

Triggered update sending interval.

BFD

This field is not supported in the current software version.

Whether BFD is enabled:

·         Disabled—Disabled in RIP view.

·         EnabledEnabled in RIP view. RIP uses BFD single-hop echo detection for a directly connected neighbor and BFD bidirectional control detection for an indirectly connected neighbor.

·         Enabled (ctrl)Enabled in RIP view. RIP uses BFD bidirectional control detection for both directly and indirectly connected neighbors.

Silent interfaces

Silent interfaces, which do not periodically send updates.

Default routes

Indicates whether a default route is sent to RIP neighbors.

·         only—Only a default route is advertised.

·         originate—A default route is advertised along with other routes.

·         disable—No default route is advertised.

Default routes cost

Metric for a default route.

Verify-source

Indicates whether the source IP address is checked for received RIP routing updates: Enabled or Disabled.

Networks

Networks enabled with RIP.

Configured peers

Configured neighbors.

Triggered updates sent

Number of triggered updates sent.

Number of routes changes

Number of route changes.

Number of replies to queries

Number of RIP responses.

 

display rip database

Use display rip database to display active routes for a RIP process. RIP advertises active routes in RIP routing updates.

Syntax

display rip process-id database [ ip-address { mask-length | mask } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

ip-address { mask-length | mask }: Displays active routes for the specified IP address. If you do not specify this argument, the command displays all actives routes for a RIP process.

Examples

# Display active routes for RIP process 100.

<Sysname> display rip 100 database

   1.0.0.0/8, auto-summary

       1.1.1.0/24, cost 16, interface summary

       1.1.1.0/24, cost 0, nexthop 1.1.1.1, RIP-interface

       1.1.2.0/24, cost 0, imported

   2.0.0.0/8, auto-summary

   2.0.0.0/8, cost 1, nexthop 1.1.1.2

# Display active routes with destination IP address 1.1.1.0 and mask length 24 for RIP process 100.

<Sysname> display rip 100 database 1.1.1.0 24

   1.1.1.0/24, cost 16, interface summary

   1.1.1.0/24, cost 0, nexthop 1.1.1.1, RIP-interface

Table 23 Command output

Field

Description

cost

Cost of the route.

auto-summary

Indicates that the route is a RIP automatic summary route.

interface summary

Indicates that the route is a RIP interface summary route.

nexthop

Address of the next hop.

RIP-interface

Direct route on a RIP-enabled interface.

imported

Indicates that the route is redistributed from another routing protocol.

 

display rip graceful-restart

Use display rip graceful-restart to display the GR status for a RIP process.

Syntax

display rip [ process-id ] graceful-restart

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535. If you do not specify this argument, the command displays the GR status for all RIP processes.

Examples

# Display the GR status for RIP process 1.

<Sysname> display rip 1 graceful-restart

 RIP process: 1

 Graceful Restart capability     : Enabled

 Current GR state                : Normal

 Graceful Restart period         : 60  seconds

 Graceful Restart remaining time : 0   seconds

Table 24 Command output

Field

Description

Graceful Restart capability

Indicates whether GR is enabled: Enabled or Disabled.

Current GR state

GR state:

·         Under GR—GR is in progress.

·         Normal—No GR is in progress or GR has completed.

Graceful Restart period

GR interval.

 

display rip interface

Use display rip interface to display RIP interface information for a RIP process.

Syntax

display rip process-id interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

interface-type interface-number: Specifies an interface by its type and number. If no interface is specified, the command displays information about all RIP interfaces for the RIP process.

Examples

# Display information about all interfaces for RIP process 1.

<Sysname> display rip 1 interface

Total: 1

 

 Interface: Vlan-interface10

    Address/Mask: 1.1.1.1/24          Version: RIPv1

    MetricIn: 0                       MetricIn route policy: Not designated

    MetricOut: 1                      MetricOut route policy: Not designated

    Split-horizon/Poison-reverse: On/Off  Input/Output: On/On

    Default route: Off

    Update output delay:  20(ms)      Output count: 3

    BFD: Disabled

    Current number of packets/Maximum number of packets: 0/2000

Table 25 Command output

Field

Description

Total

Number of interfaces running RIP.

Interface

Name of an interface running RIP.

Address/Mask

IP address and mask of the interface.

Version

RIP version running on the interface.

MetricIn

Additional metric added to incoming routes.

MetricIn route policy

Name of the routing policy used to add an additional metric for incoming routes. If no routing policy is used, the field displays Not designated.

MetricOut

Additional metric added to outgoing routes.

MetricOut route policy

Name of the routing policy used to add an additional routing metric for outgoing routes. If no routing policy is used, the field displays Not designated.

Split-horizon

Indicates whether split horizon is enabled:

·         on—Enabled.

·         off—Disabled.

Poison-reverse

Indicates whether poison reverse is enabled:

·         on—Enabled.

·         off—Disabled.

Input/Output

Indicates whether the interface is enabled to receive and send RIP messages:

·         on—Enabled.

·         off—Disabled.

Default route

Indicates whether to send a default route to RIP neighbors:

·         Only—Advertises only a default route.

·         Originate—Advertises both a default route and other routes.

·         No-originate—Advertises only non-default routes.

·         Off—Advertises no default route.

Default route cost

Metric for a default route.

Update output delay

RIP packet sending interval.

Output count

Maximum number of RIP packets that can be sent at each interval.

BFD

This field is not supported in the current software version.

Whether BFD for RIP is enabled:

·         Disabled—Disabled in interface view and RIP view.

·         EnabledEnabled on the RIP interface. The interface uses BFD single-hop echo detection for a directly connected neighbor and BFD bidirectional control detection for an indirectly connected neighbor.

·         Enabled (ctrl)Enabled on the RIP interface. The interface uses BFD bidirectional control detection for both directly and indirectly connected neighbors.

·         Enabled, inheritedEnabled in RIP view. RIP uses BFD single-hop echo detection for a directly connected neighbor and BFD bidirectional control detection for an indirectly connected neighbor. The RIP interface uses the BFD setting configured in RIP view.

·         Enabled (ctrl), inheritedEnabled in RIP view. RIP uses BFD bidirectional control detection for both directly and indirectly connected neighbors. The RIP interface uses the BFD setting configured in RIP view.

·         Enabled (destination)Enabled on the RIP interface. The interface uses BFD single-hop echo detection for a specific destination.

Current number of packets /Maximum number of packets

Number of RIP packets to be sent/maximum number of RIP packets that can be sent within a certain interval.

 

display rip neighbor

Use display rip neighbor to display neighbor information for a RIP process.

Syntax

display rip process-id neighbor [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify this argument, the command displays all neighbor information for the RIP process.

Examples

# Display neighbor information for RIP process 1.

<Sysname> display rip 1 neighbor

 Neighbor address: 197.168.2.3

     Interface  : Vlan-interface10

     Version    : RIPv2     Last update: 00h00m02s

     Relay nbr  : N/A       BFD session: N/A

     Bad packets: 0         Bad routes : 0

Table 26 Command output

Field

Description

Interface

Output interface that is connected to the neighbor.

Version

Version of RIP that the neighbor runs.

Last update

Time elapsed since the most recent update.

Relay nbr

Relay neighbor type.

BFD session

This field is not supported in the current software version.

BFD session type.

Bad packets

Number of received bad packets.

Bad routes

Number of received bad routes.

TRIP

TRIP neighbor.

 

display rip route

Use display rip route to display routing information for a RIP process.

Syntax

display rip process-id route [ ip-address { mask-length | mask } [ verbose ] | peer ip-address | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

ip-address { mask-length | mask }: Displays route information for the specified IP address.

verbose: Displays all routing information for the specified destination IP address. If you do not specify this keyword, the command displays only information about optimal routes with the specified destination IP address.

peer ip-address: Displays route information learned from the specified neighbor.

statistics: Displays route statistics, including the total number of routes and number of routes from each neighbor.

Usage guidelines

If no optional parameters are specified, the display rip process-id route command displays all routing information for a RIP process.

Examples

# Display all routing information for RIP process 1.

<Sysname> display rip 1 route

 Route Flags: R - RIP, T - TRIP

              P - Permanent, A - Aging, S - Suppressed, G - Garbage-collect

              D - Direct, O - Optimal, F - Flush to RIB

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

 Peer 1.1.1.1 on Vlan-interface10

      Destination/Mask        Nexthop           Cost    Tag     Flags   Sec

      3.0.0.0/8               1.1.1.1           1       0       RAOF    24

 Local route

      Destination/Mask        Nexthop           Cost    Tag     Flags   Sec

      4.4.4.4/32              0.0.0.0           0       0       RDOF    -

      1.1.1.0/24              0.0.0.0           0       0       RDOF    -

# Display specified routing information for RIP process 1.

<Sysname> display rip 1 route 3.0.0.0 8 verbose

 Route Flags: R - RIP, T - TRIP

              P - Permanent, A - Aging, S - Suppressed, G - Garbage-collect

              D - Direct, O - Optimal, F - Flush to RIB

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

 Peer 1.1.1.1 on Vlan-interface10

  Destination/Mask    OrigNexthop/RealNexthop          Cost  Tag   Flags Sec

  3.0.0.0/8           1.1.1.1/1.1.1.1                  1     0     RAOF  16

Table 27 Command output

Field

Description

Route Flags

·         R—RIP route.

·         T—TRIP route. (This route flag is not supported in the current software version).

·         P—The route never ages out.

·         A—The route is aging.

·         S—The route is suppressed.

·         G—The route is in Garbage-collect state.

·         D—The route is a direct route.

·         O—The route is an optimal route.

·         F—The route has been flushed to the RIB.

Peer X.X.X.X on interface-type interface-number

Routing information learned from a neighbor on a RIP interface.

Local route

Locally generated direct routes.

Destination/Mask

Destination IP address and subnet mask.

Nexthop

Next hop of the route.

OrigNexthop/RealNexthop

If the route is from a directly connected neighbor, the original next hop is the real next hop.

If the route is from an indirectly connected neighbor, the RealNexthop field displays the recursive next hop for the route. Otherwise, the field is blank.

Cost

Cost of the route.

Tag

Route tag.

Flags

Route state.

Sec

Remaining time of the timer corresponding to the route state.

 

# Display routing statistics for RIP process 1.

<Sysname> display rip 1 route statistics

 Peer                    Optimal/Aging       Optimal/Permanent       Garbage

 1.1.1.1                 1/1                 0/0                     0

 Local                   2/0                 0/0                     0

 Total                   3/1                 0/0                     0

Table 28 Command output

Field

Description

Peer

IP address of a neighbor.

Optimal

Total number of optimal routes.

Aging

Total number of aging routes.

Permanent

Total number of routes that never age out.

Garbage

Total number of routes in the Garbage-collection state.

Local

Total number of locally generated direct routes.

Total

Total number of routes learned from all RIP neighbors.

 

filter-policy export

Use filter-policy export to configure RIP to filter redistributed routes.

Use undo filter-policy export to remove the filtering.

Syntax

filter-policy { ipv4-acl-number | prefix-list prefix-list-name } export [ interface-type interface-number | direct | rip [ process-id ] | static ]

undo filter-policy export [ interface-type interface-number | direct | rip [ process-id ] | static ]

Default

RIP does not filter redistributed routes.

Views

RIP view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 ACL by its number in the range of 2000 to 3999 to filter redistributed routes.

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

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

direct: Filters direct routes.

rip: Filters routes redistributed from RIP.

process-id: Specifies the process ID of RIP, in the range of 1 to 65535. The default value is 1.

Usage guidelines

You can configure only one filtering policy to filter routes redistributed from a routing protocol or an interface. Without any protocol or interface specified, the filtering policy applies globally. If you execute this command multiple times, the most recent configuration takes effect.

To remove the filtering policy configured for a protocol or an interface, use the undo filter-policy export command with the protocol or interface specified.

To reference an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL using one of the following methods:

·          To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command.

·          To deny/permit a route with the specified destination and mask, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command.

The source keyword specifies the destination address of a route and the destination keyword specifies the subnet mask of the route. The specified subnet mask must be contiguous. Otherwise, the mask configuration does not take effect.

Examples

# Use basic ACL 2000 to filter redistributed routes.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule deny source 192.168.10.0 0.0.0.255

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 2000 export

# Use IP prefix list abc to filter redistributed routes.

<Sysname> system-view

[Sysname] ip prefix-list abc index 10 permit 11.0.0.0 8

[Sysname] rip 1

[Sysname-rip-1] filter-policy prefix-list abc export

# Configure advanced ACL 3000 to permit only route 113.0.0.0/16 to pass. Use ACL 3000 to filter redistributed routes.

<Sysname> system-view

[Sysname] acl advanced 3000

[Sysname-acl-ipv4-adv-3000] rule 10 permit ip source 113.0.0.0 0 destination 255.255.0.0 0

[Sysname-acl-ipv4-adv-3000] rule 100 deny ip

[Sysname-acl-ipv4-adv-3000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 3000 export

Related commands

acl (ACL and QoS Command Reference)

import-route

filter-policy import

Use filter-policy import to configure RIP to filter received routes.

Use undo filter-policy import to remove the filtering.

Syntax

filter-policy { ipv4-acl-number | gateway prefix-list-name | prefix-list prefix-list-name [ gateway prefix-list-name ] } import [ interface-type interface-number ]

undo filter-policy import [ interface-type interface-number ]

Default

RIP does not filter received routes.

Views

RIP view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 ACL by its number in the range of 2000 to 3999 to filter received routes.

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

gateway prefix-list-name: Specifies an IP prefix list by its name, a case-sensitive string of 1 to 63 characters, to filter routes based on their next hops.

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

Usage guidelines

You can configure only one filtering policy to filter routes received on an interface. Without any interface specified, the filtering policy applies globally. If you execute this command multiple times, the most recent configuration takes effect.

To remove the filtering policy configured for an interface, use the undo filter-policy import command with the interface specified.

To reference an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL using one of the following methods:

·          To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command

·          To deny/permit a route with the specified destination and mask, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command.

The source keyword specifies the destination address of a route and the destination keyword specifies the subnet mask of the route. The subnet mask must be contiguous. Otherwise, the mask configuration does not take effect.

Examples

# Use basic ACL 2000 to filter received RIP routes.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule deny source 192.168.10.0 0.0.0.255

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 2000 import

# Use IP prefix list abc to filter received RIP routes.

<Sysname> system-view

[Sysname] ip prefix-list abc index 10 permit 11.0.0.0 8

[Sysname] rip 1

[Sysname-rip-1] filter-policy prefix-list abc import

# Configure advanced ACL 3000 to permit only route 113.0.0.0/16 to pass. Use ACL 3000 to filter received routes.

<Sysname> system-view

[Sysname] acl advanced 3000

[Sysname-acl-ipv4-adv-3000] rule 10 permit ip source 113.0.0.0 0 destination 255.255.0.0 0

[Sysname-acl-ipv4-adv-3000] rule 100 deny ip

[Sysname-acl-ipv4-adv-3000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 3000 import

Related commands

acl (ACL and QoS Command Reference)

graceful-restart

Use graceful-restart to enable RIP GR.

Use undo graceful-restart to disable RIP GR.

Syntax

graceful-restart

undo graceful-restart

Default

RIP GR is disabled.

Views

RIP view

Predefined user roles

network-admin

Usage guidelines

The graceful-restart command and the non-stop-routing command are mutually exclusive.

Examples

# Enable GR for RIP process 1.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] graceful-restart

graceful-restart interval

Use graceful-restart interval to set the GR interval.

Use undo graceful-restart interval to restore the default.

Syntax

graceful-restart interval interval

undo graceful-restart interval

Default

The GR interval is 60 seconds.

Views

RIP view

Predefined user roles

network-admin

Parameters

interval: Specifies the GR interval in the range of 5 to 360 seconds.

Examples

# Set the GR interval to 200 seconds for RIP process 1.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] graceful-restart interval 200

host-route

Use host-route to enable host route reception.

Use undo host-route to disable host route reception.

Syntax

host-route

undo host-route

Default

RIP receives host routes.

Views

RIP view

Predefined user roles

network-admin

Usage guidelines

A router might receive many host routes from the same subnet. These routes are not helpful for routing and occupy a large number of resources. To solve this problem, use the undo host-route command to disable RIP from receiving host routes.

This command takes effect only for RIPv2 routes.

Examples

# Disable RIP from receiving host routes.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] undo host-route

import-route

Use import-route to enable RIP to redistribute external routes.

Use undo import-route to disable route redistribution.

Syntax

import-route { direct | static } [ cost cost-value | tag tag ] *

import-route rip [ process-id | all-processes ] [ allow-direct | cost cost-value | tag tag ] *

undo import-route { direct | rip [ process-id | all-processes ] | static }

Default

RIP does not redistribute external routes.

Views

RIP view

Predefined user roles

network-admin

Parameters

direct: Redistributes direct routes.

static: Redistributes static routes.

process-id: Specifies a process by its ID for RIP, in the range of 1 to 65535. The default is 1.

all-processes: Specifies all processes of RIP.

allow-direct: Redistributes the networks of the local interfaces enabled with the specified routing protocol. If you do not specify this keyword, the command does not redistribute the networks of the local interfaces.

cost cost-value: Specifies a cost for redistributed routes, in the range of 0 to 16. The default cost is 0.

tag tag: Specifies a tag for marking redistributed routes, in the range of 0 to 65535. The default is 0.

Usage guidelines

This command redistributes only active routes. To view route state information, use the display ip routing-table protocol command.

When you execute the undo form of the command, per-process setting has higher priority than the all-processes setting. The undo import-route rip all-processes command cannot remove the setting configured for a process by using the import-route rip process-id command. To remove the setting for that process, you must specify the process ID in the undo form of the command.

Examples

# Redistribute static routes into RIP, and set the cost for redistributed routes to 4.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] import-route static cost 4

Related commands

default cost

maximum load-balancing

Use maximum load-balancing to set the maximum number of equal-cost multi-path (ECMP) routes for load balancing.

Use undo maximum load-balancing to restore the default.

Syntax

maximum load-balancing number

undo maximum load-balancing

Default

The maximum number of RIP ECMP routes is 4.

Views

RIP view

Predefined user roles

network-admin

Parameters

number: Specifies the maximum number of ECMP routes, in the range of 1 to 4.

Usage guidelines

If you use the max-ecmp-num command to set the maximum number of ECMP routes supported by the system to m, the following events occur:

·          The default setting for the maximum load-balancing command is m.

·          The value range for the number argument of the maximum load-balancing command is 1 to m.

Examples

# Set the maximum number of ECMP routes to 2.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1] maximum load-balancing 2

Related commands

max-ecmp-num

network

Use network to enable RIP on an interface attached to a specified network.

Use undo network to disable RIP on an interface attached to a specified network.

Syntax

network network-address [ wildcard-mask ]

undo network network-address

Default

RIP is disabled on an interface.

Views

RIP view

Predefined user roles

network-admin

Parameters

network-address: Specifies a subnet address where an interface resides.

wildcard-mask: Specifies an IP address wildcard mask. A wildcard mask can be thought of as a subnet mask, with 1s and 0s inverted. For example, a wildcard mask of 255.255.255.0 corresponds to a subnet mask of 0.0.0.255. If you do not specify this argument, the command uses the natural mask.

Usage guidelines

RIP runs only on an interface attached to the specified network, which can be configured with a wildcard mask. An interface not on the specified network does not receive or send RIP routes, or advertise its direct routes.

For a single RIP process, the network 0.0.0.0 command can enable RIP on all interfaces. If multiple RIP processes exist, the command is not applicable.

If a physical interface is attached to multiple networks, you cannot advertise these networks in different RIP processes.

Examples

# Enable RIP process 100 on the interface attached to the network 129.102.0.0.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] network 129.102.0.0

Related commands

rip enable

output-delay

Use output-delay to set the rate at which an interface sends RIP packets.

Use undo output-delay to restore the default.

Syntax

output-delay time count count

undo output-delay

Default

An interface sends up to three RIP packets every 20 milliseconds.

Views

RIP view

Predefined user roles

network-admin

Parameters

time: Specifies the sending interval in the range of 10 to 100 milliseconds.

count: Specifies the maximum number of RIP packets sent at each interval, in the range of 1 to 30.

Examples

# Configure all interfaces running RIP process 1 to send up to 10 RIP packets every 60 milliseconds.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] output-delay 60 count 10

peer

Use peer to specify a RIP neighbor in the NBMA network, where routing updates destined for the neighbor are only unicasts and not multicast or broadcast.

Use undo peer to remove a RIP neighbor.

Syntax

peer ip-address

undo peer ip-address

Default

RIP does not unicast updates to any neighbor.

Views

RIP view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IP address of a RIP neighbor, in dotted decimal notation.

Usage guidelines

Do not use the peer ip-address command when the neighbor is directly connected. Otherwise, the neighbor might receive both unicast and multicast (or broadcast) messages with the same routing information.

This command must be executed together with the undo validate-source-address command, which disables source IP address check on inbound RIP routing updates.

Examples

# Configure RIP to unicast updates to peer 202.38.165.1.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] peer 202.38.165.1

Related commands

validate-source-address

preference

Use preference to specify a preference for RIP routes.

Use undo preference to restore the default.

Syntax

preference preference

undo preference

Default

The preference of RIP routes is 100.

Views

RIP view

Predefined user roles

network-admin

Parameters

preference: Specifies a preference for RIP routes, in the range of 1 to 255. The smaller the value, the higher the preference.

Examples

# Set a preference of 120 for RIP routes.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] preference 120

reset rip process

Use reset rip process to reset a RIP process.

Syntax

reset rip process-id process

Views

User view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

Usage guidelines

After executing the command, you are prompted to confirm the operation.

Examples

# Reset RIP process 100.

<Sysname> reset rip 100 process

Reset RIP process? [Y/N]:y

reset rip statistics

Use reset rip statistics to clear statistics for a RIP process.

Syntax

reset rip process-id statistics

Views

User view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

Examples

# Clear statistics for RIP process 100.

<Sysname> reset rip 100 statistics

rip

Use rip to enable RIP and enter RIP view.

Use undo rip to disable RIP.

Syntax

rip [ process-id ]

undo rip [ process-id ]

Default

RIP is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535. The default is 1.

Usage guidelines

You must enable a RIP process before configuring global parameters for it. This restriction does not apply to configuring interface parameters.

If you disable a RIP process, the configured interface parameters become invalid.

Examples

# Enable RIP process 1 and enter RIP view.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1]

rip authentication-mode

Use rip authentication-mode to configure RIPv2 authentication.

Use undo rip authentication-mode to restore the default.

Syntax

rip authentication-mode { md5 { rfc2082 { cipher | plain } string key-id | rfc2453 { cipher | plain } string } | simple { cipher | plain } string }

undo rip authentication-mode

Default

RIPv2 authentication is not configured.

Views

Interface view

Predefined user roles

network-admin

Parameters

md5: Specifies the MD5 authentication.

rfc2082: Uses the message format defined in RFC 2082.

cipher: Specifies a password in encrypted form.

plain: Specifies a password in plaintext form. For security purposes, the password specified in plaintext form will be stored in encrypted form.

string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 16 characters. Its encrypted form is a case-sensitive string of 33 to 53 characters.

key-id: Specifies the key ID in the range of 1 to 255.

rfc2453: Uses the message format defined in RFC 2453 (IETF standard).

simple: Specifies the simple authentication mode.

Usage guidelines

A newly configured key overwrites the old one, if any.

Although you can specify an authentication mode for RIPv1 in interface view, the configuration does not take effect because RIPv1 does not support authentication.

Examples

# Configure MD5 authentication on VLAN-interface 10 and specify a plaintext key rose in the format defined in RFC 2453.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip version 2

[Sysname-Vlan-interface10] rip authentication-mode md5 rfc2453 plain rose

Related commands

rip version

rip default-route

Use rip default-route to configure a RIP interface to advertise a default route with a specified metric.

Use undo rip default-route to disable a RIP interface from sending a default route.

Syntax

rip default-route { { only | originate } [ cost cost-value ] | no-originate }

undo rip default-route

Default

A RIP interface advertises a default route if the RIP process that the interface runs is enabled to advertise a default route.

Views

Interface view

Predefined user roles

network-admin

Parameters

only: Advertises only a default route.

originate: Advertises both a default route and other routes.

cost-value: Specifies a cost for the default route, in the range of 1 to 15. The default is 1.

no-originate: Advertises only non-default routes.

Usage guidelines

An interface that is enabled to advertise a default route does not receive any default route from RIP neighbors.

Examples

# Configure VLAN-interface 10 to advertise only a default route with a metric of 2.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip default-route only cost 2

# Configure VLAN-interface 10 to advertise a default route with a metric of 2 and other routes.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip default-route originate cost 2

Related commands

default-route

rip enable

Use rip enable to enable RIP on an interface.

Use undo rip enable to disable RIP on an interface.

Syntax

rip process-id enable [ exclude-subip ]

undo rip enable

Default

RIP is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

exclude-subip: Excludes secondary IP addresses from being enabled with RIP. If you do not specify this keyword, RIP is also enabled on secondary IP addresses of a RIP-enabled interface.

Usage guidelines

The rip enable command has a higher priority than the network command.

Examples

# Enable RIP process 100 on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip 100 enable

Related commands

network

rip input

Use rip input to enable an interface to receive RIP messages.

Use undo rip input to disable an interface from receiving RIP messages.

Syntax

rip input

undo rip input

Default

An interface is enabled to receive RIP messages.

Views

Interface view

Predefined user roles

network-admin

Examples

# Disable VLAN-interface 10 from receiving RIP messages.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] undo rip input

rip max-packet-length

Use rip max-packet-length to set the maximum length of RIP packets.

Use undo rip max-packet-length to restore the default.

Syntax

rip max-packet-length value

undo rip max-packet-length

Default

The maximum length of RIP packets is 512 bytes.

Views

Interface view

Predefined user roles

network-admin

Parameters

value: Specifies the maximum length of RIP packets, in the range of 32 to 65535 bytes.

Usage guidelines

If the configured value in the rip max-packet-length command is greater than the MTU of an interface, the interface MTU value is used as the maximum length of RIP packets.

The supported maximum length of RIP packets varies by vendor. Use this feature with caution to avoid compatibility issues.

When authentication is enabled, follow these guidelines to ensure packet forwarding:

·          For simple authentication, the maximum length of RIP packets must be no less than 52 bytes.

·          For MD5 authentication (with packet format defined in RFC 2453), the maximum length of RIP packets must be no less than 56 bytes.

·          For MD5 authentication (with packet format defined in RFC 2082), the maximum length of RIP packets must be no less than 72 bytes.

Examples

# Set the maximum length of RIP packets on VLAN-interface 10 to 1024 bytes.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip max-packet-length 1024

rip metricin

Use rip metricin to configure an interface to add a metric to inbound routes.

Use undo rip metricin to restore the default.

Syntax

rip metricin value

undo rip metricin

Default

The additional metric of an inbound route is 0.

Views

Interface view

Predefined user roles

network-admin

Parameters

value: Adds an additional metric to inbound routes, in the range of 0 to 16.

Usage guidelines

When a valid RIP route is received, the system adds a metric to it and then installs it into the routing table. The metric of the route received on the configured interface is then increased. If the sum of the additional metric and the original metric is greater than 16, the metric of the route will be 16.

Examples

# Configure VLAN-interface 10 to add a metric of 2 to inbound routes.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip metricin 2

Related commands

apply cost

rip metricout

Use rip metricout to configure an interface to add a metric to outbound routes.

Use undo rip metricout to restore the default.

Syntax

rip metricout value

undo rip metricout

Default

The additional metric for outbound routes is 1.

Views

Interface view

Predefined user roles

network-admin

Parameters

value: Adds an additional metric to outbound routes, in the range of 1 to 16.

Usage guidelines

With the command executed on an interface, the metric of RIP routes sent on the interface will be increased.

Examples

# Configure VLAN-interface 10 to add a metric of 2 to outbound routes.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip metricout 2

Related commands

apply cost

rip mib-binding

Use rip mib-binding to bind a RIP process to MIB.

Use undo rip mib-binding to restore the default.

Syntax

rip mib-binding process-id

undo rip mib-binding

Default

MIB operation is bound to the RIP process with the smallest process ID.

Views

System view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

Usage guidelines

If the specified process ID does not exist, the MIB binding configuration does not take effect.

Deleting a RIP process bound to MIB operation deletes the MIB binding configuration. After the RIP process is deleted, MIB operation is bound to the RIP process with the smallest process ID.

Examples

# Bind RIP process 100 to MIB.

<Sysname> system-view

[Sysname] rip mib-binding 100

rip output

Use rip output to enable an interface to send RIP messages.

Use undo rip output to disable an interface from sending RIP messages.

Syntax

rip output

undo rip output

Default

An interface sends RIP messages.

Views

Interface view

Predefined user roles

network-admin

Examples

# Disable VLAN-interface 10 from sending RIP messages.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] undo rip output

rip output-delay

Use rip output-delay to set the RIP packet sending interval for an interface and the maximum number of RIP packets that can be sent at each interval.

Use undo rip output-delay to restore the default.

Syntax

rip output-delay time count count

undo rip output-delay

Default

An interface uses the RIP packet sending rate set for the RIP process that the interface runs.

Views

Interface view

Predefined user roles

network-admin

Parameters

Time: Specifies the RIP packet sending interval in the range of 10 to 100 milliseconds.

count: Specifies the maximum number of RIP packets sent at each interval, in the range of 1 to 30.

Examples

# Configure VLAN-interface 10 to send a maximum of six RIP packets every 30 milliseconds.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip output-delay 30 count 6

Related commands

output-delay

rip poison-reverse

Use rip poison-reverse to enable the poison reverse feature.

Use undo rip poison-reverse to disable the poison reverse feature.

Syntax

rip poison-reverse

undo rip poison-reverse

Default

The poison reverse feature is disabled.

Views

Interface view

Predefined user roles

network-admin

Examples

# Enable the poison reverse feature on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip poison-reverse

rip split-horizon

Use rip split-horizon to enable the split horizon feature.

Use undo rip split-horizon to disable the split horizon feature.

Syntax

rip split-horizon

undo rip split-horizon

Default

The split horizon feature is enabled.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

The split horizon feature prevents routing loops. If you want to disable the feature, make sure the operation is necessary.

If both split horizon and poison reverse are enabled, only the poison reverse feature takes effect.

Examples

# Enable the split horizon feature on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip split-horizon

rip summary-address

Use rip summary-address to configure a summary route on an interface.

Use undo rip summary-address to remove a summary route on an interface.

Syntax

rip summary-address ip-address { mask-length | mask }

undo rip summary-address ip-address { mask-length | mask }

Default

No summary route is configured on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the destination IP address of the summary route.

mask-length: Specifies the subnet mask length of the summary route, in the range of 0 to 32.

mask: Specifies the subnet mask of the summary route, in dotted decimal notation.

Usage guidelines

This command takes effect only when automatic route summarization is disabled.

Examples

# Configure a summary route on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip summary-address 10.0.0.0 255.255.255.0

Related commands

summary

rip version

Use rip version to specify a RIP version on an interface.

Use undo rip version to restore the default.

Syntax

rip version { 1 | 2 [ broadcast | multicast ] }

undo rip version

Default

No RIP version is configured on an interface. The interface can send RIPv1 broadcasts, and receive RIPv1 broadcasts and unicasts, and RIPv2 broadcasts, multicasts, and unicasts.

Views

Interface view

Predefined user roles

network-admin

Parameters

1: Specifies the RIP version as RIPv1.

2: Specifies the RIP version as RIPv2.

[ broadcast | multicast ]: Sends RIPv2 messages in broadcast mode or multicast mode (default).

Usage guidelines

If an interface has no RIP version configured, it uses the global RIP version. Otherwise, it uses the RIP version configured on it.

An interface running RIPv1 can perform the following operations:

·          Sends RIPv1 broadcast messages.

·          Receives RIPv1 broadcast and unicast messages.

An interface running RIPv2 in broadcast mode can perform the following operations:

·          Sends RIPv2 broadcast messages.

·          Receives RIPv1 broadcast and unicast messages, and RIPv2 broadcast, multicast, and unicast messages.

An interface running RIPv2 in multicast mode can perform the following operations:

·          Sends RIPv2 multicast messages.

·          Receives RIPv2 broadcast, multicast, and unicast messages.

Examples

# Configure RIPv2 in broadcast mode on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip version 2 broadcast

Related commands

version

silent-interface

Use silent-interface to disable interfaces from sending RIP messages. The interfaces can still receive RIP messages.

Use undo silent-interface to enable interfaces to send RIP messages.

Syntax

silent-interface { interface-type interface-number | all }

undo silent-interface { interface-type interface-number | all }

Default

All RIP interfaces can send RIP messages.

Views

RIP view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Disables a specified interface from sending RIP messages.

all: Disables all interfaces from sending RIP messages.

Examples

# Disable all VLAN interfaces from sending RIP messages except VLAN-interface 10.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] silent-interface all

[Sysname-rip-100] undo silent-interface vlan-interface 10

[Sysname-rip-100] network 131.108.0.0

summary

Use summary to enable automatic RIPv2 route summarization. Natural masks are used to advertise summary routes to reduce the size of routing tables.

Use undo summary to disable automatic RIPv2 route summarization to advertise all subnet routes.

Syntax

summary

undo summary

Default

Automatic RIPv2 route summarization is enabled.

Views

RIP view

Predefined user roles

network-admin

Usage guidelines

Automatic RIPv2 route summarization can reduce the routing table size to enhance the scalability and efficiency for large networks.

Examples

# Disable automatic RIPv2 route summarization.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1] undo summary

Related commands

rip summary-address

rip version

timer triggered

Use timer triggered to set the interval for sending triggered updates.

Use undo timer triggered to restore the default.

Syntax

timer triggered maximum-interval [ minimum-interval [ incremental-interval ] ]

undo timer triggered

Default

The maximum interval is 5 seconds, the minimum interval is 50 milliseconds, and the incremental interval is 200 milliseconds.

Views

RIP view

Predefined user roles

network-admin

Parameters

maximum-interval: Specifies the maximum interval in the range of 1 to 5 seconds.

minimum-interval: Specifies the minimum interval in the range of 10 to 5000 milliseconds.

incremental-interval: Specifies the incremental interval in the range of 100 to 1000 milliseconds.

Usage guidelines

The minimum-interval and incremental-interval cannot be greater than the maximum-interval.

For a stable network, the minimum-interval setting is used. If network changes become frequent, the triggered update sending interval is incremented by incremental-interval × 2n-2 for each triggered update until the maximum-interval is reached. The value n is the number of triggered update times.

Examples

# For RIP process 1, set the maximum interval, minimum interval, and incremental interval to 2 seconds, 100 milliseconds, and 100 milliseconds, respectively.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] timer triggered 2 100 100

timers

Use timers to set RIP timers.

Use undo timers to restore the default.

Syntax

timers { garbage-collect garbage-collect-value | suppress suppress-value | timeout timeout-value | update update-value } *

undo timers { garbage-collect | suppress | timeout | update } *

Default

The garbage-collect timer is 120 seconds, the suppress timer is 120 seconds, the timeout timer is 180 seconds, and the update timer is 30 seconds.

Views

RIP view

Predefined user roles

network-admin

Parameters

garbage-collect-value: Specifies the garbage-collect timer in the range of 1 to 3600 seconds.

suppress-value: Specifies the suppress timer in the range of 0 to 3600 seconds.

timeout-value: Specifies the timeout timer in the range of 1 to 3600 seconds.

update-value: Specifies the update timer in the range of 1 to 3600 seconds.

Usage guidelines

RIP uses the following timers:

·          Update timer—Specifies the interval between routing updates.

·          Timeout timer—Specifies the route aging time. If no update for a route is received before the timer expires, RIP sets the metric of the route to 16.

·          Suppress timer—Specifies how long a RIP route stays in suppressed state. When the metric of a route becomes 16, the route enters the suppressed state. If RIP receives an update for the route with a metric less than 16 from the same neighbor, RIP uses this route to replace the suppressed route.

·          Garbage-collect timer—Specifies the interval from when the metric of a route becomes 16 to when it is deleted from the routing table. During the garbage-collect timer length, RIP advertises the route with a metric of 16. If no update is announced for that route before the garbage-collect timer expires, RIP deletes the route from the routing table.

As a best practice, do not change the default values of these timers.

The timer lengths must be consistent on all routers on the network.

The timeout timer must be greater than the update timer.

Examples

# Set the update, timeout, suppress, and garbage-collect timers to 5, 15, 15, and 30 seconds.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] timers update 5 timeout 15 suppress 15 garbage-collect 30

validate-source-address

Use validate-source-address to enable source IP address check on inbound RIP routing updates.

Use undo validate-source-address to disable source IP address check on inbound RIP routing updates.

Syntax

validate-source-address

undo validate-source-address

Default

Source IP address check on inbound RIP routing updates is enabled.

Views

RIP view

Predefined user roles

network-admin

Examples

# Disable source IP address check on inbound RIP routing updates.

<Sysname> system-view

[Sysname-rip] rip 100

[Sysname-rip-100] undo validate-source-address

version

Use version to specify a global RIP version.

Use undo version to restore the default.

Syntax

version { 1 | 2 }

undo version

Default

No global RIP version is configured. An RIP interface can send RIPv1 broadcasts and receive RIPv1 broadcasts and unicasts, and RIPv2 broadcasts, multicasts, and unicasts.

Views

RIP view

Predefined user roles

network-admin

Parameters

1: Specifies the RIP version as RIPv1.

2: Specifies the RIP version as RIPv2. RIPv2 messages are multicast.

Usage guidelines

An interface prefers the RIP version configured on it over the global RIP version.

If no RIP version is specified for the interface and the global version is RIPv1, the interface uses RIPv1 and can perform the following operations:

·          Send RIPv1 broadcasts.

·          Receive RIPv1 broadcasts and unicasts.

If no RIP version is specified for the interface and the global version is RIPv2, the interface uses RIPv2 multicast mode and can perform the following operations:

·          Send RIPv2 multicasts.

·          Receive RIPv2 broadcasts, multicasts, and unicasts.

Examples

# Specify the global RIP version as RIPv2.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] version 2

Related commands

rip version


RIPng commands

The following compatibility matrix shows the support of hardware platforms for RIPng:

 

Hardware series

Model

Command compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

Yes

WX3800H series

WX3820H

WX3840H

No

WX5800H series

WX5860H

No

 

checkzero

Use checkzero to enable zero field check on RIPng packets.

Use undo checkzero to disable zero field check.

Syntax

checkzero

undo checkzero

Default

Zero field check is enabled.

Views

RIPng view

Predefined user roles

network-admin

Usage guidelines

Some fields in RIPng packet headers must be zero. These fields are called zero fields. You can enable zero field check on incoming RIPng packets. If a zero field of a packet contains a non-zero value, RIPng discards the packet.

Examples

# Disable zero field check on RIPng packets for RIPng 100.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100] undo checkzero

default cost

Use default cost to configure a default metric for redistributed routes.

Use undo default cost to restore the default.

Syntax

default cost cost-value

undo default cost

Default

The default metric of redistributed routes is 0.

Views

RIPng view

Predefined user roles

network-admin

Parameters

cost-value: Specifies a default metric for redistributed routes, in the range of 0 to 16.

Usage guidelines

When you use the import-route command to redistribute routes from another routing protocol without specifying a metric, the metric specified by the default cost command applies.

Examples

# Configure a default metric of 2 for redistributed routes.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100] default cost 2

Related commands

import-route

display ripng

Use display ripng to display state and configuration information for a RIPng process.

Syntax

display ripng [ process-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535. If you do not specify this argument, the command displays information about all RIPng processes.

Examples

# Display state and configuration information for all configured RIPng processes.

<Sysname> display ripng

  Public VPN-instance name:

 

RIPng process: 1

       Preference: 100

           Routing policy: abc

       Fast-reroute:

           Routing policy: abc

       Checkzero: Enabled

       Default cost: 0

       Maximum number of load balanced routes: 6

       Update time   :   30 secs  Timeout time         :  180 secs

       Suppress time :  120 secs  Garbage-collect time :  120 secs

       Update output delay:   20(ms)  Output count:    3

       Graceful-restart interval:   60 secs

       Triggered Interval : 5 50 200

       Number of periodic updates sent: 256

       Number of trigger updates sent: 1

Table 29 Command output

Field

Description

Public VPN-instance name/Private VPN-instance name

Public network or VPN where the RIPng process runs.

RIPng process

RIPng process ID.

Preference

RIPng preference.

Checkzero

Indicates whether zero field check for RIPng packet headers is enabled: Enabled or Disabled.

Default Cost

Default metric of redistributed routes.

Fast-reroute

RIPng FRR.

Maximum number of balanced paths

Maximum number of load-balanced routes.

Update time

RIPng update interval, in seconds.

Timeout time

RIPng timeout interval, in seconds.

Suppress time

RIPng suppress interval, in seconds.

Garbage-Collect time

RIPng garbage collection interval, in seconds.

Update output delay

RIPng packet sending interval, in milliseconds.

Output count

Maximum number of RIPng packets that an interface can send at an interval.

Graceful-restart interval

GR interval, in seconds.

Triggered Interval

Triggered update sending interval.

 

display ripng database

Use display ripng database to display all active routes in the advertising database for a RIPng process. RIPng advertises active routes in RIPng routing updates.

Syntax

display ripng process-id database [ ipv6-address prefix-length ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

ipv6-address prefix-length: Specifies an IPv6 address. The ipv6-address argument specifies an IPv6 address. The prefix-length argument specifies a prefix length in the range of 0 to 128.

Examples

# Display active routes for RIPng process 1.

<Sysname> display ripng 1 database

   1::/64,

        cost 0, RIPng-interface

   10::/32,

        cost 0, imported

   2::2/128,

       via FE80::20C:29FF:FE7A:E3E4, cost 1

Table 30 Command output

Field

Description

cost

Route metric value.

imported

Indicates the route is redistributed from another routing protocol.

RIPng-interface

Route learned from the interface.

via

Next hop IPv6 address.

 

display ripng graceful-restart

Use display ripng graceful-restart to display GR information.

Syntax

display ripng [ process-id ] graceful-restart

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

Examples

# Display GR information for RIPng process 1.

<Sysname> display ripng 1 graceful-restart

RIPng process: 1

 Graceful Restart capability    : Enabled

 Current GR state               : Normal

 Graceful Restart period        : 60  seconds

 Graceful Restart remaining time: 0   seconds

Table 31 Command output

Field

Description

Graceful Restart capability

Indicates whether GR is enabled: Enabled or Disabled.

Current GR state

GR state:

·         Under GR—GR is in process.

·         Normal—GR is not in progress or has completed.

 

display ripng interface

Use display ripng interface to display interface information for a RIPng process.

Syntax

display ripng process-id interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify this argument, the command displays information about all interfaces for the RIPng process.

Examples

# Display interface information for RIPng process 1.

<Sysname> display ripng 1 interface

Total: 1

 

 Interface: Vlan-interface100

         Link-local address: FE80::20C:29FF:FEC8:B4DD

         Split-horizon: On                Poison-reverse: Off

         MetricIn: 0                      MetricOut: 1

         Default route: Off

         Primary path detection mode: BFD echo

         Summary address:

                1::/16

Table 32 Command output

Field

Description

Total

Number of interfaces running RIPng.

Interface

Name of an interface running RIPng.

Link Local Address

Link-local address of an interface running RIPng.

Split-horizon

Indicates whether split horizon is enabled:

·         On—Enabled.

·         Off—Disabled.

Poison-reverse

Indicates whether poison reverse is enabled:

·         On—Enabled.

·         Off—Disabled.

MetricIn/MetricOut

Additional metric to incoming and outgoing routes.

Default route

·         Only—The interface advertises only a default route.

·         Originate—The interface advertises a default route and other RIPng routes.

·         Off—In this state, the interface does not advertise a default route.

·         In garbage-collection status—In this state, the interface advertises a default route with a metric of 16.

Default route cost

Cost of the default route.

Primary path detection mode

This field is not supported in the current software version.

BFD echo indicates that BFD single-hop echo detection is used to detect primary link failures.

 

display ripng neighbor

Use display ripng neighbor to display neighbor information for a RIPng process.

Syntax

display ripng process-id neighbor [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify this argument, the command displays information about all neighbors for the RIPng process.

Examples

# Display neighbor information for RIPng process 1.

<Sysname> display ripng 1 neighbor

Neighbor Address: FE80::230:FF:FE00:0

     Interface  : Vlan-interface1

     Version    : RIPng version 1     Last update: 00h00m27s

     Bad packets: 0                   Bad routes : 0

Table 33 Command output

Field

Description

Neighbor Address

Link-local address of a neighbor interface.

Interface

Name of a neighbor interface.

Version

Version of RIPng that a neighbor runs.

Last update

Time elapsed since the most recent update.

 

display ripng route

Use display ripng route to display all RIPng routes for a RIPng process.

Syntax

display ripng process-id route [ ipv6-address prefix-length [ verbose ] | peer ipv6-address | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

ipv6-address prefix-length: Specifies an IPv6 address. The ipv6-address argument specifies an IPv6 address. The prefix-length argument specifies a prefix length in the range of 0 to 128.

verbose: Displays all routing information for the specified destination IPv6 address. If you do not specify this keyword, the command displays only optimal RIPng routes with the specified destination IPv6 address.

peer ipv6-address: Specifies a neighbor by its IPv6 address.

statistics: Displays routing information statistics, including total number of routes and the number of routes learned from each neighbor.

Examples

# Display routing information for RIPng process 1.

<Sysname> display ripng 1 route

   Route Flags: A - Aging, S - Suppressed, G - Garbage-collect, D – Direct

                O - Optimal, F - Flush to RIB

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

 

 Peer FE80::20C:29FF:FED4:7171 on Vlan-interface100

 Destination 4::4/128,

     via FE80::20C:29FF:FED4:7171, cost 1, tag 0, AOF, 5 secs

 Local route

 Destination 3::3/128,

     via ::, cost 0, tag 0, DOF

 Destination 6::/64,

     via ::, cost 0, tag 0, DOF

# Display information of routes with specified prefix for RIPng process 1.

<Sysname> display ripng 1 route 3::3 128 verbose

   Route Flags: A - Aging, S - Suppressed, G - Garbage-collect, D – Direct

                O - Optimal, F - Flush to RIB

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

 Local route

 Destination 3::3/128,

     via ::, cost 0, tag 0, DOF

Table 34 Command output

Field

Description

A–Aging

The route is in aging state.

S–Suppressed

The route is in suppressed state.

G–Garbage-collect

The route is in Garbage-collect state.

D–Direct

The route is a direct route.

Local route

The route is a locally generated direct route.

O - Optimal

The route is an optimal route.

F - Flush to RIB

The route has been flushed to the RIB.

Peer

Neighbor connected to the interface.

Destination

IPv6 destination address.

via

Next hop IPv6 address.

cost

Routing metric value.

tag

Route tag.

secs

Time a route entry has stayed in the current state.

 

# Display routing information statistics for RIPng process 1.

<Sysname> display ripng 1 route statistics

Peer                                            Optimal/Aging    Garbage

 FE80::20C:29FF:FED4:7171                        1/2              0

 Local                                           2/0              0

 total                                           3/2              0

Table 35 Command output

Field

Description

Peer

IPv6 address of the neighbor.

Optimal

Number of optimal routes.

Aging

Number of routes in aging state.

Garbage

Number of routes in Garbage-collection state.

Local

Total number of locally generated direct route.

total

Total number of routes learned from RIPng neighbors.

 

enable ipsec-profile

Use enable ipsec-profile to apply an IPsec profile to a RIPng process.

Use undo enable ipsec-profile to remove the IPsec profile from the RIPng process.

The following compatibility matrix shows the support of hardware platforms for this command:

 

Hardware series

Model

Command compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

Yes:

·         WX1804H

·         WX1810H

·         WX1820H

No:

·         WX1840H

WX3800H series

WX3820H

WX3840H

No

WX5800H series

WX5860H

No

 

Syntax

enable ipsec-profile profile-name

undo enable ipsec-profile

Default

No IPsec profile is applied to the RIPng process.

Views

RIPng view

Predefined user roles

network-admin

Parameters

profile-name: Specifies an IPsec profile by its name, a case-insensitive string of 1 to 63 characters.

Usage guidelines

This command must reference an IPsec profile. For more information about IPsec profiles, see Security Configuration Guide.

Examples

# Apply IPsec profile profile001 to RIPng process 1.

<Sysname> system-view

[Sysname] ripng 1

[Sysname-ripng-1] enable ipsec-profile profile001

filter-policy export

Use filter-policy export to configure RIPng to filter redistributed routes.

Use undo filter-policy export to remove the filtering.

Syntax

filter-policy { ipv6-acl-number | prefix-list prefix-list-name } export [ protocol [ process-id ] ]

undo filter-policy export [ protocol [ process-id ] ]

Default

RIPng does not filter redistributed routes.

Views

RIPng view

Predefined user roles

network-admin

Parameters

ipv6-acl-number: Specifies an IPv6 ACL by its number in the range of 2000 to 3999 to filter redistributed routes.

prefix-list prefix-list-name: Specifies an IPv6 prefix list by its name, a string of 1 to 63 characters, to filter redistributed routes.

protocol: Filters routes redistributed from a routing protocol.

process-id: Specifies the process ID of the specified routing protocol, in the range of 1 to 65535. This argument is available only when the routing protocol is ripng, ospfv3, or isisv6. The default is 1.

Usage guidelines

If the protocol argument is specified, RIPng filters only routes redistributed from the specified routing protocol. Otherwise, RIPng filters all redistributed routes.

To use an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL in one of the following ways:

·          To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix command.

·          To deny/permit a route with the specified destination and prefix, use the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix destination dest dest-prefix command.

The source keyword specifies the destination address of a route and the destination keyword specifies the prefix of the route. The specified prefix must be contiguous. Otherwise, the prefix configuration does not take effect.

Examples

# Use IPv6 prefix list to filter redistributed RIPng updates.

<Sysname> system-view

[Sysname] ipv6 prefix-list abc index 10 permit 100:1:: 32

[Sysname] ripng 100

[Sysname-ripng-100] filter-policy prefix-list abc export

# Configure advanced IPv6 ACL 3000 to permit only route 2001::1/128 to pass. Use advanced IPv6 ACL 3000 to filter redistributed routes.

<Sysname> system-view

[Sysname] acl ipv6 advanced 3000

[Sysname-acl-ipv6-adv-3000] rule 10 permit ipv6 source 2001::1 128 destination ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff 128

[Sysname-acl-ipv6-adv-3000] rule 100 deny ipv6

[Sysname-acl-ipv6-adv-3000] quit

[Sysname] ripng 100

[Sysname-ripng-100] filter-policy 3000 export

filter-policy import

Use filter-policy import to configure RIPng to filter received routes.

Use undo filter-policy import to restore the default.

Syntax

filter-policy { ipv6-acl-number | prefix-list prefix-list-name } import

undo filter-policy import

Default

RIPng does not filter received routes.

Views

RIPng view

Predefined user roles

network-admin

Parameters

ipv6-acl-number: Specifies an IPv6 ACL by its number in the range of 2000 to 3999 to filter received routes.

prefix-list prefix-list-name: Specifies an IPv6 prefix list by its name, a string of 1 to 63 characters, to filter received routes.

Usage guidelines

To use an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL in one of the following ways:

·          To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix command.

·          To deny/permit a route with the specified destination and prefix, use the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix destination dest dest-prefix command.

The source keyword specifies the destination address of a route and the destination keyword specifies the prefix of the route. The prefix must be contiguous. Otherwise, the configuration does not take effect.

Examples

# Use the IPv6 prefix list abc to filter received RIPng updates.

<Sysname> system-view

[Sysname] ipv6 prefix-list abc index 10 permit 100:1:: 32

[Sysname] ripng 100

[Sysname-ripng-100] filter-policy prefix-list abc import

# Configure advanced IPv6 ACL 3000 to permit only route 2001::1/128 to pass. Use advanced IPv6 ACL 3000 to filter received routes.

<Sysname> system-view

[Sysname] acl ipv6 advanced 3000

[Sysname-acl-ipv6-adv-3000] rule 10 permit ipv6 source 2001::1 128 destination ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff 128

[Sysname-acl-ipv6-adv-3000] rule 100 deny ipv6

[Sysname-acl-ipv6-adv-3000] quit

[Sysname] ripng 100

[Sysname-ripng-100] filter-policy 3000 import

graceful-restart

Use graceful-restart to enable Graceful Restart (GR) for RIPng.

Use undo graceful-restart to disable RIPng GR.

Syntax

graceful-restart

undo graceful-restart

Default

RIPng GR is disabled.

Views

RIPng view

Predefined user roles

network-admin

Examples

# Enable GR for RIPng process 1.

<Sysname> system-view

[Sysname] ripng 1

[Sysname-ripng-1] graceful-restart

graceful-restart interval

Use graceful-restart interval to set the GR interval.

Use undo graceful-restart interval to restore the default.

Syntax

graceful-restart interval interval

undo graceful-restart interval

Default

The GR interval is 60 seconds.

Views

RIPng view

Predefined user roles

network-admin

Parameters

interval: Specifies the GR interval in the range of 5 to 360 seconds.

Examples

# Set the GR interval to 200 seconds for RIPng process 1.

<Sysname> system-view

[Sysname] ripng 1

[Sysname-ripng-1] graceful-restart interval 200

import-route

Use import-route to redistribute routes from another routing protocol.

Use undo import-route to disable route redistribution.

Syntax

import-route protocol [ process-id ] [ allow-direct | cost cost-value ] *

undo import-route protocol [ process-id ]

Default

RIPng does not redistribute routes from another routing protocol.

Views

RIPng view

Predefined user roles

network-admin

Parameters

protocol: Specifies a routing protocol from which RIPng redistributes routes.

process-id: Specifies a process by its ID in the range of 1 to 65535. The default is 1. This argument is available only when the protocol is ripng.

allow-direct: Redistributes the networks of the local interfaces enabled with the specified routing protocol. By default, the networks of the local interfaces are not redistributed.

cost cost-value: Specifies a metric for redistributed routes, in the range of 0 to 16. The default metric is 0.

Examples

# Redistribute routes from RIPng process 7 into RIPng process 100 and set the metric for redistributed routes to 7.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100] import-route ripng 7 cost 7

maximum load-balancing

Use maximum load-balancing to set the maximum number of equal-cost multi-path (ECMP) routes for load balancing.

Use undo maximum load-balancing to restore the default.

Syntax

maximum load-balancing number

undo maximum load-balancing

Default

The maximum number of RIPng ECMP routes is 4.

Views

RIPng view

Predefined user roles

network-admin

Parameters

number: Specifies the maximum number of ECMP routes, in the range of 1 to 4. When this argument takes a value of 1, RIPng does not perform load balancing.

Usage guidelines

If you use the max-ecmp-num command to set the maximum number of ECMP routes supported by the system to m:

·          The default setting for the maximum load-balancing command is m.

·          The value range for the number argument of the maximum load-balancing command is 1 to m.

Examples

# Set the maximum number of ECMP routes to 2.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100] maximum load-balancing 2

Related commands

max-ecmp-num

output-delay

Use output-delay to set the RIPng packet sending interval and the maximum number of RIPng packets that can be sent at each interval.

Use undo output-delay to restore the default.

Syntax

output-delay time count count

undo output-delay

Default

A RIPng process sends a maximum of three RIPng packets every 20 milliseconds.

Views

RIPng view

Predefined user roles

network-admin

Parameters

time: Specifies the RIPng packet sending interval in the range of 10 to 100 milliseconds.

count: Specifies the maximum number of RIPng packets sent by a RIPng process at each interval, in the range of 1 to 30.

Usage guidelines

If you configure the RIPng packet sending rate for both a RIPng process and an interface running the RIPng process, the configuration on the interface takes effect.

Examples

# Configure RIPng process 1 to send a maximum of 10 RIPng packets every 60 milliseconds.

<Sysname> system-view

[Sysname] ripng 1

[Sysname-ripng-1] output-delay 60 count 10

Related commands

ripng output-delay

preference

Use preference to set the preference for RIPng routes.

Use undo preference to restore the default.

Syntax

preference preference

undo preference

Default

The preference of RIPng routes is 100.

Views

RIPng view

Predefined user roles

network-admin

Parameters

preference: Specifies the preference for RIPng routes, in the range of 1 to 255. The smaller the value, the higher the preference.

Examples

# Set the preference for RIPng routes to 120.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100] preference 120

reset ripng process

Use reset ripng process to restart a RIPng process.

Syntax

reset ripng process-id process

Views

User view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

Usage guidelines

After executing the command, you are prompted to confirm the operation.

Examples

# Restart RIPng process 100.

<Sysname> reset ripng 100 process

Reset RIPng process? [Y/N]:y

reset ripng statistics

Use reset ripng statistics to clear statistics for a RIPng process.

Syntax

reset ripng process-id statistics

Views

User view

Predefined user roles

network-admin

network-operator

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

Examples

# Clear statistics for RIPng process 100.

<Sysname> reset ripng 100 statistics

ripng

Use ripng to enable RIPng and enter RIPng view.

Use undo ripng to disable RIPng.

Syntax

ripng [ process-id ]

undo ripng [ process-id ]

Default

RIPng is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535. The default value is 1.

Usage guidelines

Before you configure global RIPng parameters, you must create a RIPng process. This restriction does not apply to configuring interface RIPng parameters.

If you disable a RIPng process, the configured RIPng parameters become invalid.

Examples

# Create RIPng process 100 and enter its view.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100]

ripng default-route

Use ripng default-route to configure a RIPng interface to advertise a default route with a specified metric.

Use undo ripng default-route to disable a RIPng interface from sending a default route.

Syntax

ripng default-route { only | originate } [ cost cost-value ]

undo ripng default-route

Default

A RIPng process does not advertise a default route.

Views

Interface view

Predefined user roles

network-admin

Parameters

only: Advertises only an IPv6 default route (::/0).

originate: Advertises an IPv6 default route (::/0) and other routes.

cost-value: Specifies a cost for the default route, in the range of 1 to 15. The default is 1.

Usage guidelines

This command enables the interface to advertise a RIPng default route in a route update regardless of whether the default route exists in the local IPv6 routing table.

A RIPng interface configured to advertise a default route does not receive any default routes from its neighbors.

Examples

# Configure RIPng on VLAN-interface 100 to advertise only a default route.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng default-route only

# Configure RIPng on VLAN-interface 101 to advertise a default route and other routes.

<Sysname> system-view

[Sysname] interface vlan-interface 101

[Sysname-Vlan-interface101] ripng default-route originate

ripng enable

Use ripng enable to enable RIPng on an interface.

Use undo ripng enable to disable RIPng on an interface.

Syntax

ripng process-id enable

undo ripng enable

Default

RIPng is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

process-id: Specifies a RIPng process by its ID in the range of 1 to 65535.

Examples

# Enable RIPng 100 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng 100 enable

ripng ipsec-profile

Use ripng ipsec-profile to apply an IPsec profile to a RIPng interface.

Use undo ripng ipsec-profile to restore the default.

Syntax

ripng ipsec-profile profile-name

undo ripng ipsec-profile

The following compatibility matrix shows the support of hardware platforms for this command:

 

Hardware series

Model

Command compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

Yes:

·         WX1804H

·         WX1810H

·         WX1820H

No:

·         WX1840H

WX3800H series

WX3820H

WX3840H

No

WX5800H series

WX5860H

No

 

Default

No IPsec profile is applied to the RIPng interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

profile-name: Specifies an IPsec profile by its name, a case-insensitive string of 1 to 63 characters.

Usage guidelines

This command must reference an IPsec profile. For more information about IPsec profiles, see Security Configuration Guide.

Examples

# Apply IPsec profile profile001 to VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng ipsec-profile profile001

ripng metricin

Use ripng metricin to configure an interface to add a metric to inbound RIPng routes.

Use undo ripng metricin to restore the default.

Syntax

ripng metricin value

undo ripng metricin

Default

The additional metric of an inbound route is 0.

Views

Interface view

Predefined user roles

network-admin

Parameters

value: Adds an additional metric to inbound routes, in the range of 0 to 16.

Examples

# Configure VLAN-interface 100 to add a metric of 12 to inbound RIPng routes.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng metricin 12

ripng metricout

Use ripng metricout to configure an interface to add a metric to outbound RIPng routes.

Use undo ripng metricout to restore the default.

Syntax

ripng metricout value

undo ripng metricout

Default

The additional metric of outbound RIPng routes is 1.

Views

Interface view

Predefined user roles

network-admin

Parameters

value: Adds an additional metric to outbound routes, in the range of 1 to 16.

Examples

# Configure RIPng on VLAN-interface 100 to add a metric of 12 to outbound routes.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng metricout 12

ripng output-delay

Use ripng output-delay to set the RIPng packet sending interval and the maximum number of RIPng packets that can be sent by an interface at each interval.

Use undo ripng output-delay to restore the default.

Syntax

ripng output-delay time count count

undo ripng output-delay

Default

An interface uses the RIPng packet sending rate set for the RIPng process that the interface runs.

Views

Interface view

Predefined user roles

network-admin

Parameters

time: Specifies the RIPng packet sending interval in the range of 10 to 100 milliseconds.

count: Specifies the maximum number of RIPng packets sent at each interval, in the range of 1 to 30.

Usage guidelines

If you set the RIPng packet sending rate for both a RIPng process and an interface running the RIPng process, the configuration on the interface takes effect.

Examples

# Configure VLAN-interface 100 to send a maximum of six RIPng packets every 30 milliseconds.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng output-delay 30 count 6

Related commands

output-delay

ripng poison-reverse

Use ripng poison-reverse to enable poison reverse.

Use undo ripng poison-reverse to disable poison reverse.

Syntax

ripng poison-reverse

undo ripng poison-reverse

Default

Poison reverse is disabled.

Views

Interface view

Predefined user roles

network-admin

Examples

# Enable poison reverse for RIPng update messages on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng poison-reverse

ripng split-horizon

Use ripng split-horizon to enable split horizon.

Use undo ripng split-horizon to disable split horizon.

Syntax

ripng split-horizon

undo ripng split-horizon

Default

Split horizon is enabled.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

Split horizon prevents routing loops. If you want to disable this feature, make sure the operation is indispensable.

If both poison reverse and split horizon are enabled, only poison reverse takes effect.

Examples

# Enable split horizon on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ripng split-horizon

ripng summary-address

Use ripng summary-address to configure a summary network to be advertised through an interface.

Use undo ripng summary-address to remove a summary network.

Syntax

ripng summary-address ipv6-address prefix-length

undo ripng summary-address ipv6-address prefix-length

Default

No summary network is configured to be advertised through an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies the destination IPv6 address of the summary route.

prefix-length: Specifies the prefix length of the destination IPv6 address of the summary route, in the range of 0 to 128. It indicates the number of consecutive 1s of the prefix, which defines the network ID.

Usage guidelines

Networks on the summary network will not be advertised. The cost of the summary route is the lowest cost among summarized routes.

Examples

# Assign an IPv6 address with the 64-bit prefix to VLAN-interface 100 and configure a summary with the 35-bit prefix.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] ipv6 address 2001:200::3EFF:FE11:6770/64

[Sysname-Vlan-interface100] ripng summary-address 2001:200:: 35

timer triggered

Use timer triggered to set the interval for sending triggered updates.

Use undo timer triggered to restore the default.

Syntax

timer triggered maximum-interval [ minimum-interval [ incremental-interval ] ]

undo timer triggered

Default

The maximum, minimum, and incremental intervals for sending triggered updates are 5 seconds, 50 milliseconds, and 200 milliseconds, respectively.

Views

RIPng view

Predefines user roles

network-admin

Parameters

maximum-interval: Specifies the maximum interval for sending triggered updates, in the range of 1 to 5 seconds.

minimum-interval: Specifies the minimum interval for sending triggered updates, in the range of 10 to 5000 milliseconds.

incremental-interval: Specifies the incremental interval for sending triggered updates, in the range of 100 to 1000 milliseconds.

Usage guidelines

The minimum interval and the incremental interval cannot be greater than the maximum interval.

For a stable network, the minimum interval is used. If network changes become frequent, the incremental interval incremental-interval is used to increase the triggered update sending interval until the maximum-interval is reached.

Examples

# Set the maximum, minimum, and incremental intervals for sending triggered updates to 2 seconds, 100 milliseconds, and 100 milliseconds, respectively.

<Sysname> system-view

[Sysname] ripng 100

[Sysname-ripng-100] timer triggered 2 100 100

timers

Use timers to set RIPng timers.

Use undo timers to restore the default.

Syntax

timers { garbage-collect garbage-collect-value | suppress suppress-value | timeout timeout-value | update update-value } *

undo timers { garbage-collect | suppress | timeout | update } *

Default

The garbage-collect timer is 120 seconds, the suppress timer is 120 seconds, the timeout timer is 180 seconds, and the update timer is 30 seconds.

Views

RIPng view

Predefines user roles

network-admin

Parameters

garbage-collect-value: Sets the garbage-collect timer in the range of 1 to 86400 seconds.

suppress-value: Sets the suppress timer in the range of 0 to 86400 seconds.

timeout-value: Sets the timeout timer in the range of 1 to 86400 seconds.

update-value: Sets the update timer in the range of 1 to 86400 seconds.

Usage guidelines

RIPng has the following timers:

·          Update timer—Interval between update messages.

·          Timeout timer—Route aging time. If no update for a route is received before the timer expires, RIPng sets the metric of the route to 16.

·          Suppress timer—How long a RIPng route stays in suppressed state. When the metric of a route becomes 16, the route enters the suppressed state. If RIPng receives an update for the route from the same neighbor and the route in the update has a metric less than 16, RIPng uses the route to replace the suppressed route.

·          Garbage-collect timer—Interval from when the metric of a route becomes 16 to when it is deleted from the routing table. During the garbage-collect timer length, RIPng advertises the route with a metric of 16. If no update is announced for that route before the garbage-collect timer expires, RIPng deletes the route from the routing table.

As a best practice, do not change the default values of these timers.

The timer lengths must be kept consistent on all routers in the network.

Examples

# Set the update, timeout, suppress, and garbage-collect timers to 5 seconds, 15 seconds, 15 seconds, and 30 seconds.

<Sysname> system-view

[Sysname] ripng 1

[Sysname-ripng-1] timers update 5 timeout 15 suppress 15 garbage-collect 30


Index

A C D E F G H I M N O P R S T V


A

address-family ipv4,1

address-family ipv6,1

C

checkzero,95

checkzero,60

D

default cost,95

default cost,60

default-route,61

delete ipv6 static-routes all,52

delete static-routes all,43

display ip routing-table,2

display ip routing-table acl,5

display ip routing-table ip-address,8

display ip routing-table prefix-list,10

display ip routing-table protocol,11

display ip routing-table statistics,12

display ip routing-table summary,13

display ipv6 rib nib,14

display ipv6 route-direct nib,16

display ipv6 route-static nib,52

display ipv6 route-static routing-table,55

display ipv6 routing-table,19

display ipv6 routing-table acl,23

display ipv6 routing-table ipv6-address,26

display ipv6 routing-table prefix-list,29

display ipv6 routing-table protocol,30

display ipv6 routing-table statistics,31

display ipv6 routing-table summary,32

display max-ecmp-num,33

display rib nib,34

display rip,62

display rip database,64

display rip graceful-restart,65

display rip interface,66

display rip neighbor,68

display rip route,69

display ripng,96

display ripng database,97

display ripng graceful-restart,98

display ripng interface,99

display ripng neighbor,100

display ripng route,101

display route-direct nib,36

display route-static nib,43

display route-static routing-table,46

E

enable ipsec-profile,103

F

fib lifetime,38

filter-policy export,71

filter-policy export,103

filter-policy import,72

filter-policy import,105

G

graceful-restart,74

graceful-restart,106

graceful-restart interval,106

graceful-restart interval,74

H

host-route,75

I

import-route,107

import-route,75

ip route-static,48

ip route-static default-preference,50

ip route-static-group,50

ipv6 route-static,57

ipv6 route-static default-preference,58

M

max-ecmp-num,39

maximum load-balancing,107

maximum load-balancing,76

N

network,77

O

output-delay,108

output-delay,78

P

peer,78

preference,79

preference,109

prefix,51

protocol lifetime,40

R

reset ip routing-table statistics protocol,40

reset ipv6 routing-table statistics protocol,41

reset rip process,80

reset rip statistics,80

reset ripng process,109

reset ripng statistics,110

rib,41

rip,80

rip authentication-mode,81

rip default-route,82

rip enable,83

rip input,84

rip max-packet-length,84

rip metricin,85

rip metricout,85

rip mib-binding,86

rip output,87

rip output-delay,87

rip poison-reverse,88

rip split-horizon,88

rip summary-address,89

rip version,89

ripng,110

ripng default-route,111

ripng enable,111

ripng ipsec-profile,112

ripng metricin,113

ripng metricout,113

ripng output-delay,114

ripng poison-reverse,114

ripng split-horizon,115

ripng summary-address,115

S

silent-interface,90

summary,91

T

timer triggered,92

timer triggered,116

timers,117

timers,92

V

validate-source-address,93

version,94