-
Cisco IOS XR Routing Command Reference, Release 3.6
-
Preface
-
BGP Commands on Cisco IOS XR Software
-
EIGRP Commands on Cisco IOS XR Software
-
IS-IS Commands on Cisco IOS XR Software
-
OSPF Commands on Cisco IOS XR Software
-
OSPFv3 Commands on Cisco IOS XR Software
-
RIB Commands on Cisco IOS XR Software
-
RIP Commands on Cisco IOS XR Software
-
Routing Policy Commands on Cisco IOS XR Software
-
Static Routing Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
RIP Commands on Cisco IOS XR Software
default-information originate (RIP)
validate-update-source disable
RIP Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor the Routing Information Protocol (RIP).
For detailed information about RIP concepts, configuration tasks, and examples, refer to the Implementing RIP on Cisco IOS XR Software configuration guide in Cisco IOS XR Routing Configuration Guide.
auto-summary (RIP)
To enable the automatic summarization of subnet routes into network-level routes, use the auto-summary command in the appropriate configuration mode. To disable this function and send subprefix routing information across classful network boundaries, use the no form of this command.
auto-summary
no auto-summary
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the auto-summary command to turn on route summarization. Route summarization reduces the amount of routing information in the routing tables.
Disable automatic summarization if you must perform routing between disconnected subnets. When automatic summarization is off, subnets are advertised. Automatic summarization is disabled by default.
Task ID
Examples
The following example shows how to turn on RIP auto-summarization:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# auto-summaryRelated Commands
broadcast-for-v2
To send Routing Information Protocol (RIP) Version 2 output packets to a broadcast address, use the broadcast-for-v2 command in the appropriate configuration mode. To disable this feature, use the no form of this command.
broadcast-for-v2
no broadcast-for-v2
Syntax Description
This command has no arguments or keywords.
Defaults
RIPv2 output packets are not broadcasted.
Command Modes
Router configuration
VRF configuration
Interface configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the broadcast-for-v2 command to broadcast RIP Version 2 broadcast updates to hosts that do not listen to multicasts. Version 2 updates (requests and responses) will be sent to the IP broadcast address 255.255.255.255 instead of the IP multicast address 244.0.0.9.
Task ID
Examples
The following example shows how to send RIP v2 output messages to a broadcast address for all RIP interfaces:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# broadcast-for-v2clear rip
To clear VRF and interface-related information for Routing Information Protocol (RIP) such as database entries and statistics, use the clear rip command in EXEC mode.
clear rip [vrf {vrf | all}]
Syntax Description
vrf {vrf | all}
(Optional) Specifies a particular VPN routing and forwarding (VRF) instance or all VRF instances.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
RIP VRFs and interfaces that are forcibly deactivated by the software because of a severe memory state are not activated again until the out-of-memory state is cleared by using the clear rip, clear rip interface, or clear rip out-of-memory command.
Task ID
Examples
The following example shows how to clear all database, interface, and VRF entries in RIP:
RP/0/RP0/CPU0:router# clear rip vrf allRelated Commands
Clears interface-related information for RIP such as database entries and statistics.
Clears the out-of-memory state for RIP.
clear rip database
To clear only database entries from the Routing Information Protocol (RIP) topology table, use the clear rip database command in EXEC mode.
clear rip [vrf {vrf | all}] database [interface type instance]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear only database entries from the topology table for the Packet-over-SONET/SDH (POS) 0/1/0/0 interface:
RP/0/RP0/CPU0:router# clear rip database interface pos 0/1/0/0Related Commands
clear rip interface
To clear interface-related information for Routing Information Protocol (RIP) such as database entries and statistics, use the clear rip interface command in EXEC mode.
clear rip [vrf {vrf | all}] interface type instance
Syntax Description
vrf {vrf | all}
(Optional) Specifies a particular VPN routing and forwarding (VRF) instance or all VRF instances.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
RIP VRFs and interfaces that are forcibly deactivated by the software because of a severe memory state are not activated again until after out-of-memory state is cleared by using the clear rip, clear rip interface or clear rip out-of-memory command.
Task ID
Examples
The following example shows how to clear all interface-related data such as routes and statistics from the Packet-over-SONET/SDH (POS)0/1/0/0 interface:
RP/0/RP0/CPU0:router# clear rip vrf vpn-1 interface pos 0/1/0/0Related Commands
Clears VRF and interface-related information for RIP such as database entries and statistics.
Clears the out-of-memory state for RIP.
clear rip out-of-memory
To clear the out-of-memory state for Routing Information Protocol (RIP), use the clear rip out-of-memory command in EXEC mode.
clear rip [vrf {vrf | all}] out-of-memory [interface type instance]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear rip out-of-memory command, to clear the out-of-memory state completely and allow the RIP process to force the VRF or interface to shut down, if needed.
When the router begins to run out of memory, the RIP process can transition through different memory states defined as Normal, Minor, Severe, and Critical:
•
In Normal state, RIP VRFs and interfaces function normally.
•
•
•
VRFs and interfaces that are forcibly shut down in Severe state are not automatically activated when the RIP process transitions to Minor or Normal state. When a VRF or interface is forcibly brought down while in Severe state; the clear rip, clear rip interface or clear rip out-of-memory command clears the Forced Down state and reactivates the VRF or interface.
The show rip and show rip interface commands allow you to view the current out-of-memory state.
Task ID
Examples
The following example shows how to clear the out-of-memory state for a RIP process:
RP/0/RP0/CPU0:router# clear rip out-of-memoryRelated Commands
clear rip statistics
To clear the Routing Information Protocol (RIP) statistics, use the clear rip statistics command in EXEC mode.
clear rip [vrf {vrf | all}] statistics [interface type instance]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all RIP statistics:
RP/0/RP0/CPU0:router# clear rip statisticsRelated Commands
default-information originate (RIP)
To generate a default route into Routing Information Protocol (RIP), use the default-information originate command in the appropriate configuration mode. To disable this feature, use the no form of this command.
default-information originate [route-policy name]
no default-information originate
Syntax Description
Defaults
This command is disabled by default.
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to originate a default route in RIP updates based on the result of running the route policy on the routing table:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# default-information originate route-policy policy1Related Commands
Applies a routing policy to updates advertised to or received from a RIP neighbor.
default-metric (RIP)
To set default metric values for routes redistributed from other protocols into Routing Information Protocol (RIP), use the default-metric command in the appropriate configuration mode. To return to the default state, use the no form of this command.
default-metric number-value
no default-metric
Syntax Description
Defaults
Default metrics are not set.
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the default-metric command with the redistribute command to cause RIP to use the same metric value for all redistributed routes. A default metric helps solve the problem of redistributing routes with incompatible metrics by providing a reasonable substitute and enables redistribution to proceed. If you want to set different metrics for other redistributed protocols, use the route-policy option in the redistribute command.
The RIP metric used for redistributed routes is determined by the route policy. If a route policy is not configured or the route policy does not set the RIP metric, the metric is determined based on the redistributed protocol. For VPNv4 routes redistributed by BGP, the RIP metric set at the remote PE router is used, if valid.
In all other cases (BGP, IS-IS, OSPF, EIGRP, connected, static), the metric set by the default-metric command is used. If a valid metric cannot be determined, then redistribution does not happen.
Task ID
Examples
The following example shows how a router in autonomous system 109 uses both the RIP and the Open Shortest Path First (OSPF) routing protocols. The example advertises OSPF-derived routes using RIP and assigns the OSPF-derived routes a RIP metric of 10:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# vrf vpn-1RP/0/RP0/CPU0:router(config-rip-vrf)# default-metric 10RP/0/RP0/CPU0:router(config-rip-vrf)# redistribute ospf 109Related Commands
distance (RIP)
To define the administrative distance assigned to routes discovered by the Routing Information Protocol (RIP), use the distance admin-distance command in the appropriate configuration mode. To remove the distance definition from the configuration file and restore the system to its default condition, use the no form of this command.
distance admin-distance [prefix prefix-length | prefix mask]
no distance admin-distance
Syntax Description
Defaults
admin-distance: 120
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the distance command to change the preference of RIP routes over other protocol routes. When administrative distance and redistribution features are used to together, routing behavior may be affected for routes accepted from and advertised to RIP neighbors.
Numerically, an administrative distance is an integer from 0 to 255. In general, the higher the value, the lower the trust rating. An administrative distance of 255 means that the routing information source cannot be trusted at all and should be ignored.
The order in which you enter distance commands can affect the assigned administrative distances in unexpected ways.
Table 154 lists default administrative distances.
Task ID
Examples
The following example shows how to set the administrative distance for a particular prefix:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# distance 85 192.168.10.0/24Related Commands
interface (RIP)
To define the interfaces on which the Routing Information Protocol (RIP) runs and enter interface configuration mode, use the interface command in router configuration mode. To disable RIP routing for interfaces, use the no form of this command.
interface type instance
no interface type instance
Syntax Description
Defaults
When you do not specify this command in configuration mode, RIP routing for interfaces is not enabled.
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the interface command to associate a specific interface with a RIP process. The interface remains associated with the process even when the IPv4 address of the interface changes.
This command places the router in interface configuration mode, from which you can configure interface-specific settings. Commands configured under this mode (such as the broadcast-for-v2 command) are automatically bound to that interface.
Task ID
Examples
The following example shows how to enter interface configuration mode for a RIP process, and send RIP Version 2 messages to the broadcast address on the Packet-over-SONET/SDH (POS) interface 0/1/0/0:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# interface POS 0/1/0/0RP/0/RP0/CPU0:router(config-rip-if)# ?broadcast-for-v2 Specify broadcast address for RIP v2 output packetcommit Commit the configuration changes to runningdescribe Describe a command without taking real actionsdo Run an exec commandexit Exit from this submodemetric-zero-accept Accept rip update with metric 0 to compensate a common bugno Negate a command or set its defaultspassive-interface Suppress routing updates on this interfacepoison-reverse Enable poison reversereceive Advertisement receptionroute-policy Apply route policy to routing updatessend Advertisement transmissionshow Show contents of configurationsite-of-origin SOO community for prefixes learned over this interfacesplit-horizon Disable split horizonRP/0/RP0/CPU0:router(config-rip-if)# broadcast-for-v2Related Commands
maximum-paths (RIP)
To configure the maximum number of equal cost parallel routes that the Routing Information Protocol (RIP) will install into the routing table, use the maximum-paths command in the appropriate configuration mode. To remove the maximum-paths command from the configuration file and restore the system to its default condition with respect to RIP, use the no form of this command.
maximum-paths maximum
no maximum-paths
Syntax Description
maximum
Maximum number of parallel routes that RIP can install in a routing table. Range is 1 to 32 for Cisco CRS-1 routers and 1 to 16 for Cisco XR 12000 Series Routers.
Defaults
maximum (Cisco CRS-1): 4 paths
maximum (Cisco XR 12000 Series Router): 4 pathsCommand Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to allow a maximum of 16 equal cost paths to a destination:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# maximum-paths 16metric-zero-accept
To allow RIP to accept routing entries from RIP updates with a metric set to zero (0), use the metric-zero-accept command in interface configuration mode. To remove the metric-zero-accept command from the configuration file and restore the system to its default condition with respect to RIP, use the no form of this command.
metric-zero-accept
no metric-zero-accept
Syntax Description
This command has no arguments or keywords.
Defaults
RIP routes received with a metric of zero (0) are ignored.
Command Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
After the metric-zero-accept command is configured on routing entries from RIP updates, RIP accepts these routes and then sets the metric to one (1).
Task ID
Examples
The following example shows how to set the RIP interface to accept metric zero on routing entries:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-rip-if)# metro-zero-acceptneighbor (RIP)
To define a neighboring router with which to exchange Routing Information Protocol (RIP) information, use the neighbor command in the appropriate configuration mode. To remove an entry, use the no form of this command.
neighbor ip-address
no neighbor ip-address
Syntax Description
Defaults
No neighboring routers are defined.
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the neighbor command to permit the point-to-point (nonbroadcast) exchange of routing information. When the neighbor command is used in combination with the passive-interface command in router configuration mode, routing information can be exchanged between a subset of routers and access servers on a LAN.
Multiple neighbor commands can be used to specify additional neighbors or peers.
Task ID
Examples
The following example shows how to permit the sending of RIP updates to specific neighbors. One copy of the update is generated per neighbor:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# vrf vpn-1RP/0/RP0/CPU0:router(config-rip-vrf)# neighbor 172.16.1.2Related Commands
nsf (RIP)
To configure nonstop forwarding (NSF) on Routing Information Protocol (RIP) routes after a RIP process shutdown or restart, use the nsf command in the appropriate configuration mode. To remove this command from the configuration file and restore the system to its default condition, use the no form of this command.
nsf
no nsf
Syntax Description
This command has no arguments or keywords.
Defaults
NSF is disabled.
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
When you use the nsf command, NSF lifetime is automatically set to two times the update time (with a minimum value of 60 seconds). The RIP process must reconverge within this time. If the convergence exceeds the NSF lifetime, routes are purged from the Routing Information Base (RIB) and NSF may fail.
Task ID
Examples
The following example shows how to configure RIP NSF:
RP/0/RP0/CPU0:router(config)# router ripRP/0/RP0/CPU0:router(config-rip)# vrf vpn-1RP/0/RP0/CPU0:router(config-rip-vrf)# nsfoutput-delay
To change the interpacket delay for Routing Information Protocol (RIP) updates sent, use the output-delay command in the appropriate configuration mode. To remove the delay, use the no form of this command.
output-delay delay
no output-delay delay
Syntax Description
delay
Delay (in milliseconds) between packets in a multiple-packet RIP update. The range is from 8 to 50.
Defaults
The default is no delay.
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the output-delay command if you are sending at high speed to a low-speed router that might not be able to receive at the high speed. Configuring this command helps prevent the routing table from losing information.
Task ID
Examples
The following example shows how to set the interpacket delay to 10 milliseconds: