Login
- Table of Contents
-
- H3C S9500 Command Manual-Release2132[V2.03]-03 IP Routing Volume
- 00-1Cover
- 01-IP Routing Table Display Commands
- 02-BGP Commands
- 03-IS-IS Commands
- 04-OSPF Commands
- 05-RIP Commands
- 06-Routing Policy Commands
- 07-Static Routing Commands
- 08-IPv6 BGP Commands
- 09-IPv6 IS-IS Commands
- 10-IPv6 OSPFv3 commands
- 11-IPv6 RIPng Commands
- 12-IPv6 Static Routing Commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 05-RIP Commands | 127.16 KB |
Table of Contents
Chapter 1 RIP Configuration Commands
1.1 RIP Configuration Commands
1.1.9 filter-policy export (RIP view)
1.1.10 filter-policy import (RIP view)
1.1.12 import-route (RIP view)
1.1.13 maximum load-balancing (RIP view)
1.1.19 rip authentication-mode.
1.1.30 silent-interface (RIP view)
1.1.35 validate-source-address
Chapter 1 RIP Configuration Commands
1.1 RIP Configuration Commands
1.1.1 checkzero
Syntax
checkzero
undo checkzero
View
RIP view
Default Level
2: System level
Parameter
None
Description
Use the checkzero command to enable the zero field check on RIP-1 messages.
Use the undo checkzero command to disable the zero field check.
The zero field check is enabled by default.
After the zero field check is enabled, the router discards RIP-1 messages in which zero fields are non-zero. If all messages are trusty, you can disable this feature to spare the processing time of the CPU.
Examples
# Disable the zero field check on RIP-1 messages for RIP process 100.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] undo checkzero
1.1.2 debugging rip
Syntax
debugging rip process-id [ brief | event | packet [ interface interface-type interface-number ] | receive [ interface interface-type interface-number ] | send [ interface interface-type interface-number ] | timer ]
undo debugging rip process-id [ brief | event | packet [ interface interface-type interface-number ] | receive [ interface interface-type interface-number ] | send [ interface interface-type interface-number ] | timer ]
View
Default Level
1: Monitor level
Parameters
process-id: RIP process ID. If no following parameter is specified, all debugging of the RIP process is enabled.
brief: Enables RIP brief debugging.
event: Enables RIP event debugging.
packet: Enables RIP packet debugging.
receive: Enables RIP debugging of received packets.
send: Enables RIP debugging of sent packets.
interface interface-type interface-number: Enables the specified debugging on the interface.
timer: Enables RIP timer debugging.
Description
Use the debugging rip command to enable specified RIP debugging.
Use the undo debugging command to disable specified RIP debugging.
RIP debugging is disabled by default.
Examples
# Enable RIP brief debugging on the RIP enabled device with RIP enabled on a specified interface.
<Sysname> debugging rip 1 brief
*Oct 23 14:13:20:808 2006 Sysname RM/6/RMDEBUG: RIP 1 : Sending v2 response on Vlan-interface11 from 12.0.0.1
// RIP process 1 sends a RIPv2 response via VLAN-interface11, and the source IP address is 12.0.0.1.
*Oct 23 14:17:40:320 2006 Sysname RM/6/RMDEBUG: RIP 1 : Receiving v2 response on Vlan-interface11 from 12.0.0.1
// RIP process 1 receives a RIPv2 response from VLAN-interface11, and the source IP address is 12.0.0.1.
# Enable RIP timer debugging.
<Sysname> debugging rip 1 timer
*Oct 23 14:21:01:382 2006 Sysname RM/6/RMDEBUG: RIP 1 : Periodic timer expired
// The update timer of RIP process 1 timed out.
# Enable RIP debugging of sent packets on the RIP enabled device with RIP enabled on a specified interface.
<Sysname> debugging rip 1 send
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: RIP 1 : Sending response on interface Vlan-interface11 from 12.0.0.1 to 224.0.0.9
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: Packet : vers 2, cmd response, length 108
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: authentication-mode: MD5 Digest: 4de038ea.69b217e7.2ca5a091.9f8e3bd9
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: Sequence: e717b269 (11230)
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 4.4.4.4/255.255.255.255, nexthop 0.0.0.0, cost 1, tag 0
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 12.0.0.0/255.0.0.0, nexthop 0.0.0.0, cost 2, tag 0
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 22.0.0.0/255.0.0.0, nexthop 0.0.0.0, cost 1, tag 0
*Oct 23 14:27:37:150 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 55.4.4.4/255.255.255.255, nexthop 0.0.0.0, cost 1, tag 0
// RIP process 1 sent a response to the multicast address 224.0.0.9 through VLAN-interface11, and the source IP address is 12.0.0.1.
// Packet version is RIPv2, and the length of the response is 108 bytes.
// The authentication mode is MD5. The MD5 digest is 4de038ea.69b217e7.2ca5a091.9f8e3bd9. The sequence number is e717b269, and timestamp is 11230.
// The packet contains 4 route entries with AFI field being 2: Destination 4.4.4.4/255.255.255.255, next hop 0.0.0.0, cost 1, tag 0; destination 12.0.0.0/255.0.0.0, next hop 0.0.0.0, cost 2, tag 0; destination 22.0.0.0/255.0.0.0, next hop 0.0.0.0, cost 1, tag 0; destination 55.4.4.4/255.255.255.255, next hop 0.0.0.0, cost 1, tag 0.
# Enable RIP debugging of sent packets on the RIP enabled device with TRIP enabled on a specified interface.
<Sysname> debugging rip 1 send
*Oct 23 14:39:05:380 2006 Sysname RM/6/RMDEBUG: TRIP 1 : Sending acknowledgement on interface Serial0/2/0 to 22.0.0.2
*Oct 23 14:39:05:390 2006 Sysname RM/6/RMDEBUG: Packet : vers 2, cmd acknowledgement (FLUSH), length 8, sequence num 0
// TRIP process 1 sent a TRIP acknowledgement to IP address 22.0.0.2 through Serial 0/2/0.
// The RIP version of the packet with FLUSH is 2. The packet length is 8 bytes, and sequence number is 0.
# Enable RIP debugging of received packets on the RIP enabled device with RIP enabled on a specified interface.
<Sysname> debugging rip 1 receive
*Oct 23 14:44:44:610 2006 Sysname RM/6/RMDEBUG: RIP 1 : Receive response from 12.0.0.1 on Vlan-interface11
*Oct 23 14:44:44:620 2006 Sysname RM/6/RMDEBUG: Packet : vers 2, cmd response, length 108
*Oct 23 14:44:44:630 2006 Sysname RM/6/RMDEBUG: authentication-mode: MD5 Digest: e4429d25.d9251034.e5c0fc9e.25f7d9a1
*Oct 23 14:44:44:640 2006 Sysname RM/6/RMDEBUG: Sequence: 341025d9 (12252)
*Oct 23 14:44:44:650 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 4.4.4.4/255.255.255.255, nexthop 0.0.0.0, cost 1, tag 0
*Oct 23 14:44:44:650 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 12.0.0.0/255.0.0.0, nexthop 0.0.0.0, cost 2, tag 0
*Oct 23 14:44:44:660 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 22.0.0.0/255.0.0.0, nexthop 0.0.0.0, cost 1, tag 0
*Oct 23 14:44:44:670 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 55.4.4.4/255.255.255.255, nexthop 0.0.0.0, cost 1, tag 0
*Oct 23 14:44:44:680 2006 Sysname RM/3/RMDEBUG: RIP 1 : Ignoring this packet. Authentication validation failed.
// RIP process 1 received a response from VLAN-interface11 at 12.0.0.1.
// Packet version is RIPv2, and the length is 108 bytes.
// The authentication mode is MD5. The MD5 digest is e4429d25.d9251034.e5c0fc9e.25f7d9a1. The sequence number is 341025d9, and timestamp is 12252.
// The packet contains 4 route entries with AFI field being 2: Destination 4.4.4.4/255.255.255.255, next hop 0.0.0.0, cost 1, tag 0; destination 12.0.0.0/255.0.0.0, next hop 0.0.0.0, cost 2, tag 0; destination 22.0.0.0/255.0.0.0, next hop 0.0.0.0, cost 1, tag 0; destination 55.4.4.4/255.255.255.255, next hop 0.0.0.0, cost 1, tag 0.
# Enable RIP debugging of received packets on the RIP enabled device with TRIP enabled on a specified interface.
<Sysname> debugging rip 1 receive
*Oct 23 14:52:40:298 2006 Sysname RM/6/RMDEBUG: TRIP 1 : Receive response on Serial0/2/0 from 22.0.0.1
*Oct 23 14:52:40:298 2006 Sysname RM/6/RMDEBUG: Packet : vers 2, cmd response, length 28, sequence num 1
*Oct 23 14:52:40:298 2006 Sysname RM/6/RMDEBUG: AFI 2, dest 12.0.0.0/255.0.0.0, nexthop 0.0.0.0, cost 16, tag 0
// TRIP process 1 received a TRIP response from Serial 0/2/0, and the receiving IP address is 22.0.0.1.
// The RIP version of the packet without FLUSH is 2. The packet length is 28 bytes, and sequence number is 1.
// The packet contains a route entry with the AFI field being 2: Destination 12.0.0.0/255.0.0.0, next hop 0.0.0.0, cost 16, tag 0.
# Enable RIP event debugging on the RIP enabled device with RIP enabled on a specified interface.
<Sysname> debugging rip 1 event
*Oct 23 15:00:55:202 2006 Sysname RM/6/RMDEBUG: RIP 1 : Rebuilding of Database has started
*Oct 23 15:00:55:212 2006 Sysname RM/6/RMDEBUG: RIP 1 : Database has been rebuilt
// RIP process 1 started to rebuild the database.
*Oct 23 15:02:11:00 2006 Sysname RM/6/RMDEBUG: RIP 1 : Adding Vlan-interface11 to Network List
// VLAN-interface11 is enabled with RIP process 1.
*Oct 23 15:02:01:633 2006 Sysname RM/6/RMDEBUG: RIP 1 : Removing Vlan-interface11 from Network List
// VLAN-interface11 is disabled with RIP process 1.
*Oct 23 15:02:01:622 2006 Sysname RM/6/RMDEBUG: RIP 1 : Triggered update sent
// RIP process 1 sent a triggered update.
*Oct 23 15:06:09:306 2006 Sysname RM/6/RMDEBUG: RIP 1 : prefix list used in filter-policy import has changed
// The IP prefix list referenced by the inbound filter policy has changed.
*Oct 23 15:07:41:590 2006 Sysname RM/6/RMDEBUG: RIP 1 : acl used in filter-policy export has changed
// The ACL referenced by the outbound filter policy has changed.
*Oct 23 15:08:34:422 2006 Sysname RM/6/RMDEBUG: RIP 1 : route-policy used in import-route has changed
// The routing policy for route redistribution has changed.
*Oct 23 15:09:11:398 2006 Sysname RM/6/RMDEBUG: RIP 1 : route-policy used in preference has changed
// The routing policy for preference configuration has changed.
# Enable RIP event debugging on the RIP enabled device with TRIP enabled on a specified interface.
<Sysname> debugging rip 1 event
*Oct 23 15:03:39:194 2006 Sysname RM/3/RMDEBUG: TRIP 1 : TRIP's neighbour changes to DOWN status for neighbour deleted.
// The neighbor of TRIP process 1 is removed, and the neighbor’s state changed to DOWN.
*Oct 23 15:04:07:04 2006 Sysname RM/3/RMDEBUG: TRIP 1 : TRIP's neighbour changes to NEW status.
// TRIP process 1 created a new neighbor, and the neighbor state changed to NEW.
*Oct 23 15:04:07:14 2006 Sysname RM/3/RMDEBUG: TRIP 1 : TRIP's neighbour changes to UP status.
// The neighbor’s state changed to UP.
*Oct 23 15:04:07:34 2006 Sysname RM/3/RMDEBUG: TRIP 1 : TRIP's neighbour changes from UP to FULL status.
// The neighbor’s state changed from UP to FULL.
1.1.3 default cost (RIP view)
Syntax
default cost value
undo default cost
View
RIP view
Default Level
2: System level
Parameters
value: Default metric of redistributed routes.
Description
Use the default cost command to configure the default metric for redistributed routes.
Use the undo default cost command to restore the default.
By default, the default metric of redistributed routes is 0.
When you use the import-route command to redistribute routes from other protocols without specifying a metric, the metric specified by the default cost command applies.
Related commands: import-route.
Examples
# Set the default metric for redistributed routes to 3.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] default cost 3
1.1.4 default-route originate
Syntax
default-route originate cost value
undo default-route originate
View
Default Level
2: System level
Parameters
value: Cost of the default route.
Description
Use the default-route originate cost command to advertise a default route with the specified metric to RIP neighbors.
Use the undo default-route originate command to disable the sending of a default route.
By default, no default route is sent to RIP neighbors.
The RIP router with this feature configured will not receive any default routes from RIP neighbors.
Examples
# Send a default route with a metric of 2 to RIP neighbors.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] default-route originate cost 2
# Disable default route sending.
[Sysname-rip-100] undo default-route originate
1.1.5 display rip
Syntax
display rip [ process-id | vpn-instance vpn-instance-name ]
View
Any view
Default Level
1: Monitor level
Parameters
process-id: RIP process ID.
vpn-instance vpn-instance-name: Specifies a VPN instance name.
Description
Use the display rip command to display the current status and configuration information of the specified RIP process.
l If process-id is not specified, information about all configured RIP processes is displayed.
l If vpn-instance-name is specified, the RIP configuration of the specified VPN instance is displayed.
Examples
# Display the current status and configuration information of all configured RIP processes.
Public VPN-instance name :
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)
TRIP retransmit time : 5 sec(s)
TRIP response packets retransmit count : 36
Silent interfaces : None
Default routes : Disabled
Verify-source : Enabled
Networks :
Configured peers : None
Triggered updates sent : 0
Number of routes changes : 0
Number of replies to queries : 0
Table 1-1 Description on the fields of the display rip command
|
Field |
Description |
|
Public VPN-instance name (or Private VPN-instance name) |
The RIP process runs under a public VPN instance/The RIP process runs under a private VPN instance |
|
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 RIP-1 messages. |
|
Default-cost |
Default cost of the redistributed routes |
|
Summary |
Indicates whether the routing 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 |
|
Garbage-collect time |
RIP garbage collection interval |
|
TRIP retransmit time |
Interval for retransmitting TRIP update requests and responses |
|
TRIP response packets retransmit count |
Maximum retransmission count 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 |
|
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 |
1.1.6 display rip database
Syntax
display rip process-id database
View
Default Level
1: Monitor level
Parameters
process-id: RIP process ID.
Description
Use the display rip database command to display the active routes in the RIP database, which are sent in normal RIP routing updates.
Examples
# Display the active routes in the database of 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 1-2 Description on fields of the display rip database command
|
Field |
Description |
|
X.X.X.X/X |
Destination address and subnet mask |
|
cost |
Cost of the route |
|
ClassfulSumm |
Indicates the route is a RIP summary route. |
|
nexthop |
Address of the next hop |
|
Rip-interface |
Routes learnt from a RIP–enabled interface |
|
Imported |
Routes redistributed from other routing protocols |
1.1.7 display rip interface
Syntax
display rip process-id interface [ interface-type interface-number ]
View
Any view
Default Level
1: Monitor level
Parameters
process-id: RIP process ID, in the range of 1 to 65535.
interface-type interface-number: Specifies an interface.
Description
Use the display rip interface command to display the RIP interface information of the RIP process.
If no interface is specified, information about all RIP interfaces of the RIP process is displayed.
Examples
# Display all the interface information of RIP process 1.
<Sysname> display rip 1 interface
Interface-name: vlan-interface12
Address/Mask:1.1.1.1/24 MetricIn/Out:0/1 Version: RIPv1
Split-horizon/Poison-reverse:on/off Input/Output:on/on
Current packets number/Maximum packets number: 234/2000
Table 1-3 Description on the fields of the display rip interface command
|
Field |
Description |
|
Interface-name |
The name of an interface running RIP. |
|
Address/Mask |
The IP address and Mask of the interface. |
|
MetricIn/Out |
Additional routing metric added to the incoming and outgoing routes |
|
Version |
RIP version running on the interface |
|
Split-horizon |
Indicates whether the split-horizon is enabled (ON: enabled, OFF: disabled). |
|
Poison-reverse |
Indicates whether the poison-reverse is enabled (ON: enabled, OFF: disabled) |
|
Input/Output |
Indicates if the interface is allowed to receiving (Input) or sending (Output) RIP messages (on is allowed, off is not allowed). |
|
Current packets number/Maximum packets number |
Packets to be sent/Maximum packets that can be sent on the interface |
1.1.8 display rip route
Syntax
display rip process-id route [ statistics | ip-address { mask | mask-length } | peer ip-address ]
View
Default Level
1: Monitor level
Parameters
process-id: RIP process ID.
statistics: Displays the route statistics, including total number of routes and number of routes of each neighbor.
ip-address { mask | mask-length }: Displays route information about a specified IP address.
peer ip-address: Displays all routing information learned from a specified neighbor.
Description
Use the display rip route command to display the routing information of a specified RIP process.
Examples
# Display all routing information of RIP process 1.
<Sysname> display rip 1 route
Route Flags: R-RIP, T-TRIP
P-Permanent, A-Aging, S-Suppressed, G-Garbage-collect
Peer 21.0.0.23 on Ethernet1/0
Destination/Mask NextHop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.23 1 0 RA 102
34.0.0.0/8 21.0.0.23 1 0 RA 23
Peer 21.0.0.12 on Ethernet1/0
Destination/Mask NextHop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.12 1 0 RA 34
12.0.0.0/8 21.0.0.12 1 0 RA 12
# Display routing information for network 56.0.0.0/8 of RIP process 1.
<Sysname> display rip 1 route 56.0.0.0 8
Route Flags: R-RIP, T-TRIP
P-Permanent, A-Aging, S-Suppressed, G-Garbage-collect
Peer 21.0.0.23 on vlan-interface 12
Destination/Mask NextHop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.23 1 0 RA 102
Peer 21.0.0.12 on vlan-interface 12
Destination/Mask NextHop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.12 1 0 RA 34
# Display RIP process 1 routing information learned from the specified neighbor.
<Sysname> display rip 1 route peer 21.0.0.23
Route Flags: R-RIP, T-TRIP
P-Permanent, A-Aging, S-Suppressed, G-Garbage-collect
Peer 21.0.0.23 on vlan-interface 12
Destination/Mask NextHop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.23 1 0 RA 102
34.0.0.0/8 21.0.0.23 1 0 RA 23
Table 1-4 Description on the fields of the display rip route command
|
Field |
Description |
|
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 vlan-interface 12 |
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 |
The first character indicates the route is generated by RIP or TRIP, and the second character indicates the route state. |
|
Sec |
Elapsed time of the timer corresponding to the route state |
# Display the routing statistics of RIP process 1.
<Sysname> display rip 1 route statistics
Peer Aging Permanent Garbage
21.0.0.23 2 0 3
21.0.0.12 2 0 4
Total 4 0 7
Table 1-5 Description on the fields of the display rip route statistics command
|
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 |
1.1.9 filter-policy export (RIP view)
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 ]
View
RIP view
Default Level
2: System level
Parameters
acl-number: Number of the Access Control List (ACL) used for filtering outbound routes.
ip-prefix ip-prefix-name: Name of the IP prefix list used for filtering outbound routes.
protocol: Filters outbound routes redistributed from a specified routing protocol, which can be bgp, direct, isis, ospf, rip, and static.
process-id: Process ID of the specified routing protocol. You need to specify a process ID when the routing protocol is rip, ospf, or isis.
interface-type interface-number: Specifies an interface.
Description
Use the filter-policy export command to define a RIP route outbound filtering policy. Only routes not filtered out can be advertised.
Use the undo filter-policy export command to remove the configured filtering policy.
By default, RIP does not filter outbound routes.
Note that:
l If protocol is specified, RIP filters only the routes redistributed from the specified routing protocol. Otherwise, RIP filters all routes to be advertised.
l If interface-type interface-number is specified, RIP filters only the routes advertised by the specified interface. Otherwise, RIP filters routes advertised by all RIP interfaces.
& Note:
If no protocol is specified, the filter-policy export command filters all the routes to be advertised, including the routes redistributed with the import-route command and RIP routes learned from neighbors.
Related commands: acl, import-route, ip ip-prefix.
Examples
# Reference ACL 2000 to filter outbound routes.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] filter-policy 2000 export
# Reference IP prefix list abc to filter outbound routes on VLAN-interface 100.
[Sysname-rip-1] filter-policy ip-prefix abc export static Vlan-interface 100
1.1.10 filter-policy import (RIP view)
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 ]
View
RIP view
Default Level
2: System level
Parameters
acl-number: Number of the Access Control List (ACL) used for filtering incoming routes.
ip-prefix ip-prefix-name: References an IP prefix list to filter incoming routes.
gateway ip-prefix-name: References an IP prefix list to filter routes from the gateway.
interface-type interface-number: Specifies an interface.
Description
Use the filter-policy import command to filter the incoming routes.
Use the undo filter-policy import command to restore the default.
By default, RIP does not filter incoming routes.
& Note:
The filter-policy import command filters the RIP routes received from neighbors. The routes that are filtered out are neither added to the routing table nor advertised to neighbors.
Related commands: acl, ip ip-prefix.
Examples
# Reference ACL 2000 to filter incoming routes.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] filter-policy 2000 import
1.1.11 host-route
Syntax
host-route
Default Level
2: System level
undo host-route
View
RIP view
Parameters
None
Description
Use the host-route command to enable host route reception.
Use the undo host-route command to disable host route reception.
By default, receiving host routes is enabled.
In some cases, a routing device may receive many host routes from the same network segment. These routes are not helpful for routing and occupy a large amount of network resources. You can use the undo host-route command to disable receiving of host routes.
Examples
# Disable RIP from receiving host routes.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] undo host-route
1.1.12 import-route (RIP view)
Syntax
import-route protocol [ process-id ] [ allow-jbgp ] [ cost cost | route-policy route-policy-name | tag tag ]*
undo import-route protocol [ process-id ]
View
RIP view
Default Level
2: System level
Parameters
protocol: Specify a routing protocol from which to redistribute routes, currently including bgp, direct, isis, ospf, rip, rip and static.
process-id: Process ID of the routing protocol, used for isis, rip, and ospf.
cost: Cost for redistributed routes. If cost is not specified, the default cost specified by the default cost command applies.
tag: Tag marking redistributed routes. The default is 0.
route-policy route-policy-name: Specifies a routing policy with 1 to 19 characters.
allow-ibgp: When the protocol argument is set to bgp, allow-ibgp is an optional keyword. The import-route bgp command only redistributes EBGP routes, while the import-route bgp allow-ibgp command additionally redistributes IBGP routes, which may cause routing loops. Be cautious when using it.
Description
Use the import-route command to redistribute routes from other routing protocols.
Use the undo import-route command to cancel route redistribution.
By default, RIP does not redistribute routes from other routing protocols.
l You can specify a routing policy using keyword route-policy to redistribute only the specified routes.
l You can configure a cost for redistributed routes using keyword cost.
l You can configure a tag value for redistributed routes using keyword tag.
Related commands: default cost.
Examples
# Redistribute static routes, and set the cost to 4.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] import-route static cost 4
# Set the default cost for redistributed OSPF routes to 3.
[Sysname-rip-1] default cost 3
[Sysname-rip-1] import-route ospf
1.1.13 maximum load-balancing (RIP view)
Syntax
maximum load-balancing number
undo maximum load-balancing
View
RIP view
Default Level
2: System level
Parameters
number: Maximum number of equal cost routes for load balancing.
Description
Use the maximum load-balancing command to specify the maximum number of equal cost routes for load balancing.
Use the undo maximum load-balancing command to restore the default.
Examples
# Specify the maximum number of equal cost routes for load balancing as 2.
<Sysname> system-view
[Sysname] rip
[Sysname-rip-1] maximum load-balancing 2
1.1.14 network
Syntax
network network-address
undo network network-address
View
RIP view
Default Level
2: System level
Parameters
network-address: IP address of a network segment, which can be the IP network address of any interface.
Description
Use the network command to enable RIP on the interface attached to the specified network.
Use the undo network command to disable RIP on the interface attached to the specified network.
Use the network 0.0.0.0 command to enable RIP on all interfaces.
RIP is disabled on an interface by default.
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
1.1.15 peer
Syntax
peer ip-address
undo peer ip-address
View
RIP view
Default Level
2: System level
Parameters
ip-address: IP address of a peer device, in dotted decimal format.
Description
Use the peer command to specify the IP address of a neighbor in the non-broadcast multi-access (NBMA) network, where routing updates destined to the peer are unicast, rather than multicast or broadcast.
Use the undo peer command to remove the IP address of a neighbor.
By default, no neighbor is specified.
Note: you need not use the peer ip-address command when the neighbor is directly connected; otherwise the neighbor may receive both the unicast and multicast (or broadcast) of the same routing information.
Examples
# Specify to send unicast updates to peer 202.38.165.1.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] peer 202.38.165.1
1.1.16 preference
Syntax
preference [ route-policy route-policy-name ] value
undo preference [ route-policy ]
View
RIP view
Default Level
2: System level
Parameters
route-policy-name: Routing policy name.
value: Priority for RIP routes. The smaller the value, the higher the priority.
Description
Use the preference command to specify the RIP route priority.
Use the undo preference route-policy command to restore the default.
By default, the priority of RIP route is 100.
You can specify a routing policy using keyword route-policy to set the specified priority to routes matching the routing policy.
l If a priority is set for matched routes in the routing policy, the priority applies to these routes. The priority of other routes is the one set by the preference command.
l If no priority is set for matched routes in the routing policy, the priority of all routes is the one set by the preference command.
Examples
# Set the priority of RIP routes to 120.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] preference 120
1.1.17 reset rip statistics
Syntax
reset rip process-id statistics
View
User view
Default Level
2: System level
Parameters
process-id: RIP process ID.
Description
Use the reset rip statistics command to clear the statistics of the specified RIP process.
Examples
# Clear statistics of RIP process 100.
<Sysname> reset rip 100 statistics
1.1.18 rip
Syntax
rip [ process-id ] [ vpn-instance vpn-instance-name ]
undo rip [ process-id ] [ vpn-instance vpn-instance-name ]
View
Default Level
2: System level
Parameters
process-id: RIP process ID. The default is 1.
vpn-instance vpn-instance-name: Specifies a VPN instance name.
Description
Use the rip command to enable a RIP process and enter RIP view.
Use the undo rip command to disable a RIP process.
By default, no RIP process runs.
Note that:
l If no VPN instance is specified, the RIP process will run under public network instance.
l You must create a VPN instance before you apply a RIP process to it. For related configuration, refer to the ip vpn-instance command.
l You must enable the RIP process before configuring the global parameters. This limitation is not for configuration of interface parameters.
l The configured interface parameters become invalid after you disable the RIP process.
Examples
# Enable a RIP process and enter its view.
<Sysname> system-view
[Sysname] rip
[Sysname-rip-1]
1.1.19 rip authentication-mode
Syntax
rip authentication-mode { md5 { rfc2082 key-string key-id | rfc2453 key-string } | simple password }
undo rip authentication-mode
View
Interface view
Default Level
2: System level
Parameters
md5: MD5 authentication mode.
rfc2453: Uses the message format defined in RFC 2453 (IETF standard).
rfc2082: Uses the message format defined in RFC 2082.
key-id: MD5 key number, in the range of 1 to 255.
key-string: MD5 key string with 1 to 16 characters in plain text format, or 1 to 24 characters in cipher text format. When the display current-configuration command is used to display system information, a 24-character cipher string is displayed as the MD5 key string.
simple: Plain text authentication mode.
password: Plain text authentication string with 1 to 16 characters.
Description
Use the rip authentication-mode command to configure RIP-2 authentication mode and parameters.
Use the undo rip authentication-mode command to cancel authentication.
Note that the key string you configured can overwrite the old one if there is any.
Related commands: rip version.
Examples
# Configure MD5 authentication on VLAN-interface 10 with the key string being 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 rose
1.1.20 rip input
Syntax
rip input
undo rip input
View
Interface view
Default Level
2: System level
Parameters
None
Description
Use the rip input command to enable the interface to receive RIP messages.
Use the undo rip input command to disable the interface from receiving RIP messages.
By default, an interface is enabled to receive RIP messages.
Related commands: rip output.
Examples
# Disable VLAN-interface 10 from receiving RIP messages.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] undo rip input
1.1.21 rip metricin
Syntax
rip metricin value
undo rip metricin
View
Interface view
Default Level
2: System level
Parameters
value: Additional metric added to received routes. The default is 0.
Description
Use the rip metricin command to add a metric to the received routes.
Use the undo rip metricin command to restore the default.
When a valid RIP route is received, the system will add a metric to it and then put it into the routing table. Therefore, the metric of routes received on the configured interface is increased.
Related commands: rip metricout.
Examples
# Configure an additional metric of 2 for routes received on VLAN-interface 10.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] rip metricin 2
1.1.22 rip metricout
Syntax
rip metricout value
undo rip metricout
View
Interface view
Default Level
2: System level
Parameters
value: Additional metric of sent routes. The default is 1.
Description
Use the rip metricout command to add a metric to a sent route.
Use the undo rip metricout command to restore the default.
Before a RIP route is sent, a metric will be added to it. Therefore, when the metric is configured on an interface, the metric of RIP routes sent on the interface will be increased.
Related commands: rip metricin.
Examples
# Configure an additional metric of 12 for RIP routes sent on VLAN-interface 10.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] rip metricout 12
1.1.23 rip mib-binding
Syntax
rip mib-binding process-id
undo rip mib-binding
View
System view
Default Level
2: System level
Parameters
process-id: RIP process ID.
Description
Use the rip mib-binding command to bind MIB operations with a specified RIP process.
Use the undo rip mib-binding command to restore the default.
By default, MIB operations are bound to the RIP process with the smallest process ID.
Examples
# Configure RIP 100 to accept SNMP requests.
<Sysname> system-view
[Sysname] rip mib-binding 100
# Restore the default.
[Sysname] undo rip mib-binding
1.1.24 rip output
Syntax
rip output
undo rip output
View
Interface view
Default Level
2: System level
Parameters
None
Description
Use the rip output command to enable the interface to send RIP messages.
Use the undo rip output command to disable the interface from sending RIP messages.
Sending RIP messages is enabled on an interface by default.
Related commands: rip input.
Examples
# Disable VLAN-interface 10 from receiving RIP messages.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] undo rip output
1.1.25 rip poison-reverse
Syntax
rip poison-reverse
undo rip poison-reverse
View
Default Level
2: System level
Parameters
Description
Use the rip poison-reverse command to enable the poison reverse function.
Use the undo rip poison-reverse command to disable the poison reverse function.
By default, the poison reverse function is disabled.
Examples
# Enable the poison reverse function for RIP routing updates on VLAN-interface 10.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] rip poison-reverse
1.1.26 rip split-horizon
Syntax
rip split-horizon
undo rip split-horizon
View
Interface view
Default Level
2: System level
Parameters
None
Description
Use the rip split-horizon command to enable the split horizon function.
Use the undo rip split-horizon command to disable the split horizon function.
The split horizon function is enabled by default.
l The split horizon function is necessary for preventing routing loops. Therefore, you are not recommended to disable it.
l In special cases, make sure it is necessary to disable the split horizon function.
& Note:
Only the poison reverse function takes effect if both the split horizon and poison reverse functions are enabled.
Examples
# Enable the split horizon function on VLAN-interface 10.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] rip split-horizon
1.1.27 rip summary-address
Syntax
rip summary-address ip-address { mask | mask-length }
undo rip summary-address ip-address { mask | mask-length }
View
Interface view
Default Level
2: System level
Parameters
ip-address: Summary IP address.
mask: Subnet mask in dotted decimal format.
mask-length: Subnet mask length.
Description
Use the rip summary-address command to configure RIP-2 to advertise a summary route via the interface.
Use the undo rip summary-address command to remove the configuration.
Note that the summary address is valid only when the automatic summarization is disabled.
Related commands: summary.
Examples
# Advertise a local summary IP address 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
1.1.28 rip triggered
Syntax
rip triggered
undo rip triggered
View
Interface view
Default Level
2: System level
Parameters
None
Description
Use the rip triggered command to enable triggered RIP.
Use the undo rip triggered command to disable triggered RIP.
By default, the triggered RIP is disabled.
Note that triggered RIP can only run on link layer protocols PPP, Frame Relay, and X.25.
Examples
# Enable triggered RIP.
<Sysname> system-view
[Sysname] interface pos 6/1/1
[Sysname-pos 6/1/1] rip triggered
1.1.29 rip version
Syntax
rip version { 1 | 2 [ broadcast | multicast ] }
undo rip version
View
Interface view
Default Level
2: System level
Parameters
1: RIP version 1.
2: RIP version 2.
broadcast: Sends RIP-2 messages in broadcast mode.
multicast: Sends RIP-2 messages in multicast mode.
Description
Use the rip version command to specify a RIP version for the interface.
Use the undo rip version command to remove the specified RIP version.
By 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 RIP-1 broadcasts and can receive RIP-1 broadcasts and unicasts, and RIP-2 broadcasts, multicasts and unicasts.
If RIP-2 is specified with no sending mode configured, RIP-2 messages will be sent in multicast mode.
When RIP-1 runs on an interface, the interface will:
l Send RIP-1 broadcast messages
l Receive RIP-1 broadcast messages
l Receive RIP-1 unicast messages
When RIP-2 runs on the interface in broadcast mode, the interface will:
l Send RIP-2 broadcast messages
l Receive RIP-1 broadcast messages
l Receive RIP-1 unicast messages
l Receive RIP-2 broadcast messages
l Receive RIP-2 multicast messages
l Receive RIP-2 unicast messages
When RIP-2 runs on the interface in multicast mode, the interface will:
l Send RIP-2 multicast messages
l Receive RIP-2 broadcast messages
l Receive RIP-2 multicast messages
l Receive RIP-2 unicast messages
Examples
# Configure VLAN-interface 10 to broadcast RIP-2 messages.
<Sysname> system-view
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] rip version 2 broadcast
1.1.30 silent-interface (RIP view)
Syntax
silent-interface { all | interface-type interface-number }
undo silent-interface { all | interface-type interface-number }
View
Default Level
2: System level
Parameters
all: Silents all interfaces.
interface-type interface-number: Specifies an interface.
Description
Use the silent-interface command to disable an interface or all interfaces from sending routing updates. That is, the interface only receives but does not send RIP messages.
Use the undo silent-interface command to restore the default.
By default, all interfaces are allowed to send routing updates.
Examples
# Configure all Vlan interfaces to work in the silent state, and activate 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
1.1.31 summary
Syntax
summary
undo summary
View
RIP view
Default Level
2: System level
Parameters
None
Description
Use the summary command to enable automatic RIP-2 summarization. Natural masks are used to advertise summary routes so as to reduce the size of routing tables.
Use the undo summary command to disable automatic RIP-2 summarization so that all subnet routes can be broadcasted.
By default, automatic RIP-2 summarization is enabled.
Enabling automatic RIP-2 summarization can reduce the size of the routing table to enhance the scalability and efficiency of large networks.
Related commands: rip version.
Examples
# Enable RIP-2 automatic summarization.
<Sysname> system-view
[Sysname] rip
[Sysname-rip-1] summary
1.1.32 timers
Syntax
timers { garbage-collect garbage-collect-value | suppress suppress-value | timeout timeout-value | update update-value }*
undo timers { garbage-collect | suppress | timeout | update } *
View
RIP view
Default Level
2: System level
Parameters
garbage-collect-value: Garbage-collect timer time in seconds.
suppress-value: Suppress timer time in seconds.
timeout-value: Timeout timer time in seconds. The value should be at least three times the update timer value.
update-value: Update timer time in seconds.
Description
Use the timers command to configure RIP timers. By adjusting RIP timers, you can improve network performance.
Use the undo timers command to restore the default.
By default, the garbage-collect timer is 120 seconds, the suppress timer 120 seconds, the timeout timer 180 seconds, and the update timer 30 seconds.
RIP is controlled by the above four timers.
l The update timer defines the interval between routing updates.
l The timeout timer defines the route aging time. If no routing update related to a route is received after the aging time, the metric of the route is set to 16 in the routing table.
l The suppress timer defines how long a RIP route stays in the suppressed state. When the metric of a route is 16, the route enters the suppressed state. In the suppressed state, only routes which come from the same neighbor and whose metric is less than 16 will be received by the device to replace unreachable routes.
l The garbage-collect timer defines 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 the routing metric set to 16. If no routing update is announced for that route after the Garbage-Collect timer expires, the route will be deleted from the routing table.
Note that:
l Generally, you are not recommended to change the default values of these timers.
l The time lengths of these timers must be kept consistent on all routing devices and access servers in the network.
Examples
# Specifies the update, timeout, suppress, and garbage-collect timers as 5, 15, 15 and 30 respectively.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] timers update 5
[Sysname-rip-100] timers timeout 15
[Sysname-rip-100] timers suppress 15
[Sysname-rip-100] timers garbage-collect 30
1.1.33 trip retransmit count
Syntax
trip retransmit count retransmit-count-value
undo trip retransmit count
View
RIP view
Default Level
2: System level
Parameters
retransmit-count-value: Upper limit for retransmitting an Update Request or Update Response.
Description
Use the trip retransmit count command to configure the upper limit for retransmitting an Update Request or Update Response.
Use the undo validate-source-address command to restore the default.
The default upper limit is 36.
Examples
# Configure an upper limit of 20 for retransmitting an Update Request or Update Response.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] trip retransmit count 20
1.1.34 trip retransmit timer
Syntax
trip retransmit timer retransmit-time-value
undo trip retransmit timer
View
RIP view
Default Level
2: System level
Parameters
retransmit-time-value: Interval in seconds for retransmitting an Update Request or Update Response.
Description
Use the trip retransmit timer command to configure the interval for retransmitting an Update Request or Update Response.
Use the undo validate-source-address command to restore the default.
The default interval is 5 seconds.
For two routers on an analog dial-up link, the difference between retransmission intervals on the two ends must be bigger than 50 seconds; otherwise, they can not become TRIP neighbors.
Examples
# Configure an interval of 80 seconds for retransmitting an Update Request or Update Response.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] trip retransmit timer 80
1.1.35 validate-source-address
Syntax
validate-source-address
undo validate-source-address
View
RIP view
Default Level
2: System level
Parameters
None
Description
Use the validate-source-address command to enable the source IP address validation on incoming RIP routing updates.
Use the undo validate-source-address command to disable the source IP address validation.
The source IP address validation is enabled by default.
Generally, disabling the validation is not recommended.
Examples
# Enable the source IP address validation on incoming messages.
<Sysname> system-view
[Sysname-rip] rip 100
[Sysname-rip-100] validate-source-address
1.1.36 version
Syntax
version { 1 | 2 }
undo version
View
RIP view
Default Level
2: System level
Parameters
1: Specifies the RIP version as RIP-1.
2: Specifies the RIP version as RIP-2. RIP-2 messages are multicast.
Description
Use the version command to specify a global RIP version.
Use the undo version command to remove the configured global RIP version.
By default, the global RIP version is RIP-1.
Note that:
l If an interface has an RIP version specified, the RIP version takes precedence over the global one.
l If no RIP version is specified for the interface and the global version is RIP-1, the interface inherits RIP-1, and then it can send RIP-1 broadcasts, and receive RIP-1 broadcasts and unicasts.
l If no RIP version is specified for the interface and the global version is RIP-2, the interface inherits RIP-2, and then it can send RIP-2 multicasts, and receive RIP-2 broadcasts, multicasts and unicasts
Note that the global RIP version takes effect on RIP interfaces only when no interface RIP version is configured.
Examples
# Specify RIP-2 as the global RIP version.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] version 2
