This chapter provides an alphabetized reference for each of the Routing Information Protocol (RIP) commands, which support IPv4. It includes the following commands:

Use this command to specify the time period during which the authentication key on a key chain is received as valid.

Use the no option with this command to disable it.

See Appendix A, Routing Information Protocol Authentication for information on how this command is related to the other authentication commands.

None

Keychain-key mode

This command was introduced before OcNOS version 1.3.

The following example shows the setting of accept-lifetime for key-id 1 on the key chain named mychain.

Use this command to enable the metric update consistent with Cisco.

Use either the no or disable parameter with this command to disable this feature.

By default, the Cisco metric-behavior is disabled.

Router mode

This command was introduced before OcNOS version 1.3.

This example shows how to enable the metric update behavior to be consistent with Cisco in the Router mode.

Use this command to clear specific data from the RIP routing tables.

Using this command with the all parameter, clears the RIP table of all the routes. If you do not want that your RIP network to be deleted, use the redistribute connected command and make the RIP network a connected route. To delete the RIP routes learned from neighbor and also keep the RIP network intact, use the rip (clear ip rip route rip) parameter with this command.

None

Privileged Exec mode

This command was introduced before OcNOS version 1.3.

Use this command to clear all IPv4 RIP VRF route or any specific prefix RIP VRF route of any particular VRF name.

None

Privileged Exec mode

This command was introduced before OcNOS version 1.3.

Use this command to clear an IPv4 RIP statistics.

None

Privileged Exec mode

This command was introduced before OcNOS version 1.3.

 

Use this command to specify the options for the displayed debugging information for RIP events, RIP packets and RIP NSM.

Use the no parameter with this command to disable all debugging. The undebug alias command can also be used.

Disabled

Privileged Exec mode and Configure mode

This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.

The following example specifies the options for the displayed debugging information in Configure mode prompt.

The following example shows to disable all debugging in Privileged Exec mode prompt.

Use this command to add default routes to the RIP updates.

Use the no parameter with this command to disable this feature.

Disabled

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to specify the metrics to be assigned to redistributed routers.

This command is used in conjunction with the redistribute command to make the routing protocol use the specified metric value for all redistributed routes. A default metric is useful in redistributing routes with incompatible metrics. Every protocol has different metrics and can not be compared directly. Default metric provides the standard to compare. All routes that are redistributed will use the default metric.

Use the no parameter with this command to disable this feature.

By default, the metric value is set to 1.

Router mode

This command was introduced before OcNOS version 1.3.

This example assigns the cost of 10 to the OSPF routes which are redistributed into RIP.

Use this command to set the administrative distance. The administrative distance is a feature used by the routers to select the path when there are two or more different routes to the same destination from two different routing protocols. A smaller administrative distance indicating a more reliable protocol.

Use the no parameter with this command to disable this function.

By default, the administrative distance is 120.

Router mode

This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.

Use this command to filter incoming or outgoing route updates using an access list or a prefix list. You can filter out incoming or outgoing route updates using an access list or a prefix list. If you do not specify the name of the interface, the filter will be applied to all the interfaces.

Use the no parameter with this command to disable this feature.

Disabled

Router mode

This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.

Use this command to enable RIPv2 authentication on an interface and specify the name of the key chain to be used. If you do not configure a key chain results in no authentication.

Use the no parameter with this command to disable this function.

See Appendix A, Routing Information Protocol Authentication for information on how this command is related to the other authentication commands.

If you do not configure a key chain, authentication is not used.

Interface mode

This command was introduced before OcNOS version 1.3.

In the following example, interface eth0 is configured key-chain authentication and the name is specified as mykey. This name is used to enter the key-chain mode to specify the password. See the key command.

Use this command to specify the type of authentication mode used for RIP v2 packets.

Use the no parameter with this command to restore clear text authentication.

See Appendix A, Routing Information Protocol Authentication for information on how this command is related to the other authentication commands.

No authentication mode is enabled by default. But, when any authentication key (string or key-chain) is configured, text authentication mode is enabled by default.

Interface mode

This command was introduced before OcNOS version 1.3.

The following example shows md5 authentication configured on the eth1 interface, ensuring authentication of RIP packets received.

Use this command to specify the authentication string or password used by a key.

You can configure authentication for a single key or multiple keys at different times. Use this command to specify password for a single key on an interface.

Use the no parameter with this command to disable this feature.

See Appendix A, Routing Information Protocol Authentication for how this command is related to the other authentication commands.

None

Interface mode

This command was introduced before OcNOS version 1.3.

In the following example, the interface eth1 is configured to have an authentication string as guest, any receiving RIP packet in that interface should have the same string as password.

Use this command to configure the interface to enable the reception of RIP packets.

Use the no parameter with this command to disable this feature.

None

Receive-packet is enabled

Interface mode

This command was introduced before OcNOS version 1.3.

This example shows packet receiving being turned on for interface eth0.

Use this command to receive specified version of RIP packets on an interface basis using version control, and override the setting of the version command.

Use the no form of this command to use the setting established by the version command.

Version 2

Interface mode

This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.

In the following example, interface eth1 in configured to receive both RIP version 1 and 2 packets.

Use this command to enable sending RIP packets through the current interface.

Use the no parameter with this command to disable this feature.

None

Send packet is enabled.

Interface mode

This command was introduced before OcNOS version 1.3.

This example shows packet sending being turned on for interface eth0.

Use this command to send RIP packets on an interface using version control. In addition to version 1 and version 2, compatible version packets can be specified. With the parameter 1-compatible, a version 2 RIP interface will broadcast the packets instead of multicasting them.

This command applies to a specific interface and overrides any the version specified by the version command.

Use the no parameter with this command to use the global RIP version control rules.

Version 2

Interface mode

This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.

In the following example, interface eth1 is configured to send both RIP version 1 and 2 packets.

Use this command to perform the split-horizon action on the interface

This command helps avoid including routes in updates sent to the same gateway from which they were learned. Using the split horizon command omits routes learned from one neighbor, in updates sent to that neighbor. Using the poisoned parameter with this command includes such routes in updates, but sets their metrics to infinity. Thus, advertising that these routes are not reachable.

Use the no parameter with this command to disable this function.

Split horizon poisoned

Interface mode

This command was introduced before OcNOS version 1.3.

Use this command to manage, add or delete authentication keys in a key-chain. This command allows you to enter the Keychain-key mode to set a password for the key.

Use the no option with this command to disable this feature.

See Appendix A, Routing Information Protocol Authentication for information on how this command is related to the other authentication commands.

By default, RIP uses level-1-2 if there is no Level-2 instance nor a Level-1-2 instance. Otherwise, it uses level-1.

Keychain mode

This command was introduced before OcNOS version 1.3.

In the following example, the password for key-id 1 in the key chain named mychain is set to prime:

Use this command to enter the key chain management mode and to configure a key chain with a key chain name. This command allows you to enter the keychain mode to specify keys on this key chain.

Use the no option with this command to disable this feature.

See Appendix A, Routing Information Protocol Authentication for information on how this command is related to the other authentication commands.

None

Configure mode and Keychain mode

This command was introduced before OcNOS version 1.3.

The following example shows the creation of a key chain named mychain and the change into keychain mode prompt.

The following example shows the creation of a key chain named mykeychain3 in the keychain mode and the addition of an authentication key key-id 10 in the same mode.

Use this command to define a password in plain-text to be used by a key.

The password is stored as encrypted, and is displayed in encrypted text when show running-config command is executed.

Use the no parameter with this command to disable this feature.

See Appendix A, Routing Information Protocol Authentication for information on how this command is related to the other authentication commands.

Disabled

Keychain-key mode

This command was introduced before OcNOS version 1.3.

In the following example, the password for key-id 1 in the key chain named mychain is set to prime:

Use this command to define a password in its encrypted format to be used by a key.

Use the no parameter with this command to disable this feature

By default, password is not configured.

Keychain mode and Keychain-key mode.

This command was introduced in OcNOS version 4.1.

In the following example, the encrypted password for key-id 1 in the key chain named mykeychain is set to 0xd6c50b442de47f70 (equivalent to "mychain" in plain-text):

Use this command to configure the maximum prefix.

Use the no parameter with this command to disable the limiting of the number of RIP routes in the routing table.

The default maximum-prefix threshold is 75%.

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to specify a neighbor router. It is used for each connected point-to-point link. This command to exchanges non-broadcast routing information. It can be used multiple times for additional neighbors.

Passive-interface command disables sending routing updates on an interface. Use the neighbor command in conjunction with the passive-interface command to send routing updates to specific neighbors.

Use the no parameter with this command to disable the specific router.

Disabled

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to specify a network as one that runs RIP. This command specifies the networks to which routing updates will be sent and received. If a network is not specified, the interfaces in that network will not be advertised in any RIP update.

Use the no parameter with this command to remove the specified network as one that runs RIP.

Disabled

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to add an offset to in and out metrics to routes learned through RIP. This command specifies the offset value that is added to the routing metric. When the networks match the access list the offset is applied to the metrics. No change occurs if the offset value is zero.

Use the no parameter with this command to remove the offset list.

The default offset value is the interface metric value which is defined by the operating system.

Router mode

This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.

In this example the router examines the RIP updates being sent out from interface eth0 and adds 16 hops to the routes matching the ip addresses specified in the access list accesslist1.

Use this command to block RIP broadcast on the interface.

Use the no parameter with this command to disable this function.

Disabled

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to run-time configure the RIP UDP receive-buffer size.

Use the no parameter with this command to return to the default value.

The default value of the RIP UDP receive-buffer size is 32768.

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to redistribute information from other routing protocols.

Use the no parameter with this command to disable this function.

Disabled

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to configure static RIP routes.

Use the no parameter with this command to disable this function.

No route is added.

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to add a static RIP route. This command is used most often for debugging purposes and does not show up in the kernel routing table. After adding the RIP route, it can be checked in the RIP routing table.

Use this global command to enable a RIP routing process.

Use the no parameter with this command to disable RIP routing.

None

Disabled

Configure mode

This command was introduced before OcNOS version 1.3.

This command is used to begin the RIP routing process.

Use this command to specify the time period during which the authentication key on a key chain can be sent.

Use the no parameter with this command to negate this command.

Disabled

Keychain-key mode

This command was introduced before OcNOS version 1.3.

The following example shows the setting of send-lifetime for key-id 1 on the key chain named mychain:

Use this command to display the RIP debugging status for these debugging options: nsm debugging, RIP event debugging, RIP packet debugging and RIP nsm debugging.

None

None

Exec mode and Privileged Exec mode

This command was introduced before OcNOS version 1.3.

Use this command to display RIP process parameters and statistics.

None

None

Exec mode and Privileged Exec mode

This command was introduced before OcNOS version 1.3.

This is an example of the output from the show ip protocols rip command:

Figure 1-73 Explains the show command output details.

Use this command to show RIP routes.

None

Exec mode and Privileged Exec mode

This command was introduced before OcNOS version 1.3.

The following output displays the RIP routing table with the destination network, nexthop and metric to reach it.

Table 1-74 shows the status codes displayed at the start of a route entry.

Use this command to display information about RIP interfaces. You can specify an interface name to display information about a specific interface.

None

Exec mode and Privileged Exec mode

This command was introduced before OcNOS version 1.3.

The following output displays the RIP routing table with the destination network, nexthop and metric to reach it.

Figure 1-75 Explains the show command output details.

Use this command to display information about RIP statistics. You can specify an interface name to display information about a specific interface.

None

Exec mode and Privileged Exec mode

This command was introduced before OcNOS version 1.3.

The following output displays the RIP routing table with the destination network, nexthop and metric to reach it.

Figure 1-76 Explains the show command output details.

Use this command to restart SNMP in Routing Information Protocol (RIP)

None

By default, snmp restart is disabled.

Configure mode

This command was introduced before OcNOS version 1.3.

Use this command to adjust routing network timers.

This command adjusts the RIP timing parameters. Every 30 seconds, an update is sent out containing the complete routing table to every neighboring router. When the time specified by the timeout parameter expires, the route is no longer valid. However, it is retained in the routing table for a short time so that neighbors are notified that the route has been dropped. When the time specified by the garbage parameter expires, the route is finally removed from the routing table. Until the garbage time expires, the route is included in all updates sent by the router.

All routers in the network must have the same timers to allow RIP to execute a distributed and asynchronous routing algorithms. The timers should not be synchronized as it might lead to unnecessary collisions on the network.

Use the no parameter with this command to restore the default routing network timers.

The default routing table update time is 30 seconds.

The default routing information timeout time is 180 seconds.

The default routing garbage collection time is 120 seconds.

Router mode

This command was introduced before OcNOS version 1.3.

Use this command to specify a RIP version used globally by the router. RIP can be run in version 1 as well as version 2 mode. Version 2 has more features than version 1 including authentication. Once the rip version is set, rip packets of that version will be received and sent on all the rip-enabled interfaces.

Use the no parameter with this command to restore the default version.

Version 2

Router mode

This command was introduced before OcNOS version 1.3.