Contents

RIP configuration commands· 1

checkzero· 1

default cost (RIP view) 1

default-route· 2

display rip· 3

display rip database· 4

display rip interface· 5

display rip route· 7

filter-policy export (RIP view) 8

filter-policy import (RIP view) 10

host-route· 11

import-route (RIP view) 11

maximum load-balancing (RIP view) 12

network· 13

output-delay· 14

peer 14

preference· 15

reset rip process· 15

reset rip statistics· 16

rip· 16

rip authentication-mode· 17

rip default-route· 18

rip input 18

rip metricin· 19

rip metricout 20

rip mib-binding· 20

rip output 21

rip poison-reverse· 21

rip split-horizon· 22

rip summary-address· 22

rip version· 23

silent-interface (RIP view) 24

summary· 24

timers· 25

validate-source-address· 26

version· 27

 

RIP configuration commands

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 function is enabled.

Views

RIP view

Default command level

2: System level

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] undo checkzero

default cost (RIP view)

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

Use undo default cost to restore the default.

Syntax

default cost value

undo default cost

Default

The default metric of redistributed routes is 0.

Views

RIP view

Default command level

2: System level

Parameters

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 100

[Sysname-rip-100] default cost 3

Related commands

import-route

default-route

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

Use undo default-route to disable all the interfaces running the RIP process from sending a default route.

Syntax

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

undo default-route

Default

No default route is sent to RIP neighbors.

Views

RIP view

Default command level

2: System level

Parameters

only: Advertises only a default route.

originate: Advertises both a default route and other routes.

cost: 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 routes from RIP neighbors.

Examples

# Configure all the 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 ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

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

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

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

<Sysname> display rip

    RIP process : 1

       RIP version : 1

       Preference : 100

       Checkzero : Enabled

       Default-cost : 0

       Summary : Enabled

       Hostroutes : Enabled

       Maximum number of balanced paths : 8

       Update time   :   30 sec(s)  Timeout time         :  180 sec(s)

       Suppress time :  120 sec(s)  Garbage-collect time :  120 sec(s)

       update output delay :   20(ms)  output count :    3

       TRIP retransmit time :    5 sec(s)

       TRIP response packets retransmit count :   36

       Silent interfaces : None

       Default routes : Only  Default route cost : 3

       Verify-source : Enabled

       Networks :

           192.168.1.0

       Configured peers : None

       Triggered updates sent : 0

       Number of routes changes : 0

       Number of replies to queries : 0

Table 1 Command output

Field	Description
RIP process	RIP process ID.
RIP version	RIP version 1 or 2.
Preference	RIP route priority.
Checkzero	Indicates whether the zero field check is enabled for RIPv1 messages.
Default-cost	Default cost of the redistributed routes.
Summary	Indicates whether route summarization is enabled.
Hostroutes	Indicates whether to receive host routes.
Maximum number of balanced paths	Maximum number of load balanced routes.
Update time	RIP update interval.
Timeout time	RIP timeout time.
Suppress time	RIP suppress interval.
update output delay	RIP packet sending interval.
output count	Maximum number of RIP packets sent at each interval.
Garbage-collect time	RIP garbage collection interval.
TRIP retransmit time	TRIP retransmit interval for sending update requests and responses.
TRIP response packets retransmit count	Maximum retransmit times for update requests and responses.
Silent interfaces	Number of 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 route cost	Cost of the default route.
Verify-source	Indicates whether the source IP address is checked on the received RIP routing updates.
Networks	Networks enabled with RIP.
Configured peers	Configured neighbors.
Triggered updates sent	Number of sent triggered updates.
Number of routes changes	Number of changed routes in the database.
Number of replies to queries	Number of RIP responses.

 

display rip database

Use display rip database to display active routes in the database of the specified RIP process, which are sent in normal RIP routing updates.

Syntax

display rip process-id database [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

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

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the active routes for RIP process 100.

<Sysname> display rip 100 database

   10.0.0.0/8, cost 1, ClassfulSumm

   10.0.0.0/24, cost 1, nexthop 10.0.0.1, Rip-interface

   11.0.0.0/8, cost 1, ClassfulSumm

   11.0.0.0/24, cost 1, nexthop 10.0.0.1, Imported

Table 2 Command output

Field	Description
X.X.X.X/X	Destination address and subnet mask.
cost	Cost of the route.
classful-summ	Indicates that the route is a RIP summary route.
Nexthop	Address of the next hop.
Rip-interface	Routes learned from a RIP-enabled interface.
imported	Routes redistributed from other routing protocols.

 

display rip interface

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

Syntax

display rip process-id interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

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.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

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

 

 Interface-name: GigabitEthernet1/0/5

         Address/Mask:1.1.1.1/24        Version:RIPv1

         MetricIn:5                     MetricIn route policy:123

         MetricOut:5                    MetricOut route policy:234

         Split-horizon/Poison-reverse:on/off  Input/Output:on/on

         Default route:off

         Current packets number/Maximum packets number:234/2000

Table 3 Command output

Field	Description
Interface-name	Name of an interface running RIP.
Address/Mask	IP address and mask of the interface.
Version	RIP version running on the interface.
MetricIn	Additional routing metric added to the incoming routes.
MetricIn route policy	Name of the routing policy used to add the additional routing metric for the incoming routes. If no routing policy is referenced, the field displays Not designated.
MetricOut	Additional routing metric added to the outgoing routes.
MetricOut route policy	Name of the routing policy used to add the additional routing metric for the outgoing routes. If no routing policy is referenced, 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 if the interface is allowed to receive (Input) or send (Output) RIP messages: ·     on—Allowed. ·     off—Not allowed.
Default route	Indicates whether sending the default route to RIP neighbors is allowed: ·     on—Allowed. ·     off—Not allowed.
Current packets number/Maximum packets number	Packets to be sent/Maximum packets that can be sent on the interface.

 

display rip route

Use display rip route to display the routing information of a specified RIP process.

Syntax

display rip process-id route [ ip-address { mask | mask-length } | peer ip-address | statistics ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

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

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

peer ip-address: Displays all routing information learned from a specified neighbor.

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

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

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

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

 Peer 111.1.1.2  on GigabitEthernet1/0/5

      Destination/Mask        Nexthop     Cost    Tag   Flags   Sec

        122.0.0.0/8          111.1.1.2      1       0    RA      22

Table 4 Command output

Field	Description
Route Flags	Route flags: ·     R—RIP route. ·     T—TRIP route. ·     P—The route never expires. ·     A—The route is aging. ·     S—The route is suppressed. ·     G—The route is in Garbage-collect state.
Peer 21.0.0.23 on GigabitEthernet1/0/5	Routing information learned on a RIP interface from the specified neighbor.
Destination/Mask	Destination IP address and subnet mask.
Nexthop	Next hop of the route.
Cost	Cost of the route.
Tag	Route tag.
Flags	Indicates the route state.
Sec	Remaining time of the timer corresponding to the route state.

 

# Display the routing statistics for RIP process 1.

<Sysname> display rip 1 route statistics

 Peer            Aging     Permanent    Garbage

 111.1.1.2        1         0             0

 Total            1         0             0

Table 5 Command output

Field	Description
Peer	IP address of a neighbor.
Aging	Total number of aging routes learned from the specified neighbor.
Permanent	Total number of permanent routes learned from the specified neighbor.
Garbage	Total number of routes in the Garbage-collection state learned from the specified neighbor.
Total	Total number of routes learned from all RIP neighbors.

 

filter-policy export (RIP view)

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

Use undo filter-policy export to remove the filtering.

Syntax

filter-policy { acl-number | ip-prefix ip-prefix-name } export [ protocol [ process-id ] | interface-type interface-number ]

undo filter-policy export [ protocol [ process-id ] | interface-type interface-number ]

Default

RIP does not filter outbound routes.

Views

RIP view

Default command level

2: System level

Parameters

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

ip-prefix ip-prefix-name: Specifies an IP prefix list by its name, a string of 1 to 19 characters, to filter outbound routes.

protocol: Filters outbound routes redistributed from a specified routing protocol, which can be direct, rip, and static.

process-id: Specifies the process ID of the specified routing protocol, in the range of 1 to 65535. You need to specify a process ID when the routing protocol is rip.

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

Usage guidelines

If a protocol is specified, RIP filters only the routes redistributed from the specified routing protocol. Otherwise, RIP filters all outbound routes.

If an interface is, RIP filters only the routes advertised by the specified interface. Otherwise, RIP filters routes advertised by all RIP interfaces.

To reference 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 } 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 configuration does not take effect.

Examples

# Use ACL 2000 to filter outbound routes.

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] rip 1

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

# Use IP prefix list abc to filter outbound routes on GigabitEthernet 1/0/5.

[Sysname-rip-1] filter-policy ip-prefix abc export gigabitethernet 1/0/5

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

<Sysname> system-view

[Sysname] acl number 3000

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

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

[Sysname-acl-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 (RIP view)

Use filter-policy import to configure RIP to filter the inbound routes.

Use undo filter-policy import to restore the default.

Syntax

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

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

Default

RIP does not filter inbound routes.

Views

RIP view

Default command level

2: System level

Parameters

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

ip-prefix ip-prefix-name: Specifes an IP prefix list by its name, a string of 1 to 19 characters, to filter inbound routes.

gateway ip-prefix-name: Specifies an IP prefix list by its name, a string of 1 to 19 characters, to filter routes from the gateway.

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

Usage guidelines

To reference 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 } 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 configuration does not take effect.

Examples

# Use ACL 2000 to filter inbound RIP routes.

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] rip 1

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

# Use IP prefix list abc on GigabitEthernet 1/0/5 to filter all inbound RIP routes.

[Sysname-rip-1] filter-policy ip-prefix abc import gigabitethernet 1/0/5

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

<Sysname> system-view

[Sysname] acl number 3000

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

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

[Sysname-acl-adv-3000] quit

[Sysname] rip 1

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

Related commands

acl (ACL and QoS Command Reference)

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

Default command level

2: System level

Usage guidelines

A router might receive many host routes from the same subnet. These routes are not helpful for routing and occupy many 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.

Examples

# Disable RIP from receiving host routes.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] undo host-route

import-route (RIP view)

Use import-route to enable route redistribution from another routing protocol.

Use undo import-route to disable route redistribution.

Syntax

import-route protocol [ process-id | all-processes ] [ cost cost | tag tag ] *

undo import-route protocol [ process-id | all-processes ]

Default

RIP does not redistribute routes from any other routing protocol.

Views

RIP view

Default command level

2: System level

Parameters

protocol: Specifies a routing protocol from which to redistribute routes. It can be direct, rip, or static.

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

all-processes: Enables route redistribution from all the processes of the specified protocol. This keyword takes effect only when the protocol is rip.

cost:  Specifies a cost for redistributed routes, in the range of 0 to 16. If no cost is specified, the default cost specified by the default cost command applies.

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.

The undo import-route protocol all-processes command removes only the configuration made by the import-route protocol all-processes command, instead of the configuration made by the import-route protocol process-id 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

# Configure a default cost of 3 for redistributed routes.

[Sysname-rip-1] default cost 3

Related commands

default cost

maximum load-balancing (RIP view)

Use maximum load-balancing to specify 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 ECMP routes is 4.

Views

RIP view

Default command level

2: System level

Parameters

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

Examples

# Specify the maximum number of ECMP routes as 2.

<Sysname> system-view

[Sysname] rip

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

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

undo network network-address

Default

RIP is disabled on an interface.

Views

RIP view

Default command level

2: System level

Parameters

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

Usage guidelines

RIP runs only on an interfaces attached to the specified network. An interface not on the specified network does not receive or send routes, or advertise its direct routes.

For a single 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 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

output-delay

Use output-delay to configure 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

Default command level

2: System level

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

Examples

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

<Sysname> system-view

[Sysname] rip 1

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

peer

Use peer to specify an IP address for a neighbor in the NBMA network, where routing updates destined for the peer are unicast, rather than multicast or broadcast.

Use undo peer to remove the IP address of a neighbor.

Syntax

peer ip-address

undo peer ip-address

Default

No neighbor is specified.

Views

RIP view

Default command level

2: System level

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 the same routing information in both unicast and multicast (or broadcast) mode.

Examples

# Specify RIP to unicast updates to peer 202.38.165.1.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] peer 202.38.165.1

preference

Use preference to specify a preference for RIP routes.

Use undo preference to restore the default.

Syntax

preference value

undo preference

Default

The preference of RIP routes is 100.

Views

RIP view

Default command level

2: System level

Parameters

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

Default command level

1: Monitor level

Parameters

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

Usage guidelines

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

Examples

# Reset RIP process 100.

<Sysname> reset rip 100 process

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

Default command level

2: System level

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 create a RIP process and enter RIP view.

Use undo rip to disable a RIP process.

Syntax

rip [ process-id ]

undo rip [ process-id ]

Default

No RIP process runs.

Views

System view

Default command level

2: System level

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 create a RIP process before configuring global parameters for it. This restriction does not apply to configuring interface parameters.

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

Examples

# Create a RIP process and enter RIP process 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 cancel RIPv2 authentication.

Syntax

rip authentication-mode { md5 { rfc2082 [ cipher ] key-string key-id | rfc2453 [ cipher ] key-string } | simple [ cipher ] password }

undo rip authentication-mode

Views

Interface view

Default command level

2: System level

Parameters

md5: Specifies the MD5 authentication mode.

rfc2082: Uses the message format defined in RFC 2082.

cipher: Sets a ciphertext authentication key or password. If this keyword is not specified, you set a plaintext authentication key or password.

key-string: Specifies the MD5 key string. This argument is case sensitive. It must be a plaintext string of 1 to 16 characters, or a ciphertext string of 33 to 53 characters.

key-id: Specifies the MD5 key number, in the range of 1 to 255.

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

simple: Specifies the simple authentication mode.

password: Sets the password in simple authentication mode. This argument is case sensitive. It must be a plaintext string of 1 to 16 characters, or a ciphertext string of 33 to 53 characters.

Usage guidelines

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

For secrecy, all keys or passwords, including keys or passwords configured in plain text, are saved in cipher text.

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 GigabitEthernet 1/0/5, and specify a plaintext key rose in the format defined in RFC 2453.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip version 2

[Sysname-GigabitEthernet1/0/5] rip authentication-mode md5 rfc2453 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 the RIP interface from sending a default route.

Syntax

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

undo rip default-route

Default

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

Views

Interface view

Default command level

2: System level

Parameters

only: Advertises only a default route.

originate: Advertises a default route and other routes.

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

no-originate: Advertises only non-default route.

Usage guidelines

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

Examples

# Configure GigabitEthernet 1/0/5 to advertise only a default route with a metric of 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip default-route only cost 2

Related commands

default-route

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

Default command level

2: System level

Examples

# Enable GigabitEthernet 1/0/5 to receive RIP messages.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip input

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

Default command level

2: System level

Parameters

value: Add 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 GigabitEthernet 1/0/5 to add a metric of 6 to the inbound route 1.0.0.0/8 and to add a metric of 2 to other inbound routes.

<Sysname> system-view

[Sysname] ip ip-prefix 123 permit 1.0.0.0 8

[Sysname] route-policy abc permit node 0

[Sysname-route-policy] if-match ip-prefix 123

[Sysname-route-policy] apply cost 6

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip metricin route-policy abc 2

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

Parameters

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

Usage guidelines

With the command configured on an interface, the metric of RIP routes sent on the interface is increased.

Examples

# Configure GigabitEthernet 1/0/5 to add a metric of 6 to the outbound route 1.0.0.0/8 and to add a metric of 2 to other outbound routes.

<Sysname> system-view

[Sysname] ip ip-prefix 123 permit 1.0.0.0 8

[Sysname] route-policy abc permit node 0

[Sysname-route-policy] if-match ip-prefix 123

[Sysname-route-policy] apply cost 6

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip metricout route-policy abc 2

rip mib-binding

Use rip mib-binding to bind MIB operations with a specified RIP process, so that the RIP process can receive SNMP requests.

Use undo rip mib-binding to restore the default.

Syntax

rip mib-binding process-id

undo rip mib-binding

Default

MIB operations are bound to RIP process 1. RIP process 1 is enabled to receive SNMP requests.

Views

System view

Default command level

2: System level

Parameters

process-id: RIP process ID, in the range of 1 to 65535.

Examples

# Enable RIP process 100 to receive SNMP requests.

<Sysname> system-view

[Sysname] rip mib-binding 100

# Restore the default.

[Sysname] undo rip mib-binding

rip output

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

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

Syntax

rip output

undo rip output

Default

Sending RIP messages is enabled on an interface.

Views

Interface view

Default command level

2: System level

Examples

# Enable GigabitEthernet 1/0/5 to receive RIP messages.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip output

rip poison-reverse

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

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

Syntax

rip poison-reverse

undo rip poison-reverse

Default

The poison reverse function is disabled.

Views

Interface view

Default command level

2: System level

Examples

# Enable the poison reverse function for RIP routing updates on GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip poison-reverse

rip split-horizon

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

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

Syntax

rip split-horizon

undo rip split-horizon

Default

The split horizon function is enabled.

Views

Interface view

Default command level

2: System level

Usage guidelines

·     The split horizon function prevents routing loops. If you want to disable the function, make sure the operation is dispensable.

·     On NBMA networks, such as FR and X.25 where multiple VCs are configured on the primary and secondary interfaces, disable split horizon to ensure route advertisement.

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

Examples

# Enable the split horizon function on GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip split-horizon

rip summary-address

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

Use undo rip summary-address to remove the configuration.

Syntax

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

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

Views

Interface view

Default command level

2: System level

Parameters

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

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

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

Usage guidelines

The summary address takes effect only when the automatic summarization is disabled.

Examples

# Advertise a local summary address on GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip summary-address 10.0.0.0 255.255.255.0

Related commands

summary

rip version

Use rip version to specify a RIP version for the interface.

Use undo rip version to remove the specified RIP version.

Syntax

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

undo rip version

Default

No RIP version is configured for an interface, which uses the global RIP version. If the global RIP version is not configured, the interface can only send RIPv1 broadcasts and can receive RIPv1 broadcasts and unicasts, and RIPv2 broadcasts, multicasts, and unicasts.

Views

Interface view

Default command level

2: System level

Parameters

1: Specifies RIP version 1.

2: Specifies RIP version 2.

broadcast: Sends RIPv2 messages in broadcast mode.

multicast: Sends RIPv2 messages in multicast mode.

Usage guidelines

If RIPv2 is specified with no sending mode configured, RIPv2 messages are sent in multicast mode.

When RIPv1 runs on an interface, the interface can perform the following operations:

·     Sends RIPv1 broadcast messages.

·     Receives RIPv1 broadcast and unicast messages.

When RIPv2 runs on the interface in broadcast mode, the interface can perform the following operations:

·     Sends RIPv2 broadcast messages.

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

When RIPv2 runs on the interface in multicast mode, the interface can perform the following operations:

·     Sends RIPv2 multicast messages.

·     Receives RIPv2 broadcast, multicast, and unicast messages.

Examples

# Configure GigabitEthernet 1/0/5 to broadcast RIPv2 messages.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] rip version 2 broadcast

silent-interface (RIP view)

Use silent-interface to disable an interface from sending routing updates. The interface can still receive routing updates.

Use undo silent-interface to restore the default.

Syntax

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

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

Default

All interfaces are allowed to send routing updates.

Views

RIP view

Default command level

2: System level

Parameters

interface-type interface-number: Disables an specified interface from sending routing updates.

all: Disables all interfaces from sending routing updates.

Examples

# Configure all interfaces to operate in silent mode except GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] silent-interface all

[Sysname-rip-100] undo silent-interface gigabitethernet 1/0/5

[Sysname-rip-100] network 131.108.0.0

summary

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

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

Syntax

summary

undo summary

Default

Automatic RIPv2 summarization is enabled.

Views

RIP view

Default command level

2: System level

Usage guidelines

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

Examples

# Disable RIPv2 automatic summarization.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1] undo summary

Related commands

rip version

timers

Use timers to configure 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

Default command level

2: System level

Parameters

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

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

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

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

Usage guidelines

RIP is controlled by 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 time expires, the metric of the route is set 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 from the same neighbor and the route in the update has a metric less than 16, RIP uses the 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.

H3C does not recommend changing the default values of these timers.

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

Examples

# Specifies the update, timeout, suppress, and garbage-collect timers as 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 the source IP address check on inbound RIP routing updates.

Use undo validate-source-address to disable the source IP address check.

Syntax

validate-source-address

undo validate-source-address

Default

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

Views

RIP view

Default command level

2: System level

Usage guidelines

H3C does not recommend disabling source IP address check.

Examples

# Disable the 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 remove the configuration.

Syntax

version { 1 | 2 }

undo version

Default

If an interface has a RIP version specified, the RIP version takes effect. If it has no RIP version specified, it can send RIPv1 broadcasts, and receive RIPv1 broadcasts and unicasts, and RIPv2 broadcasts, multicasts, and unicasts.

Views

RIP view

Default command level

2: System level

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 it can send RIPv1 broadcasts, and 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 it can send RIPv2 multicasts, and receive RIPv2 broadcasts, multicasts, and unicasts.

Examples

# Specify RIPv2 as the global RIP version.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] version 2