OcNOS-SP : Layer 3 Guide : Routing Information Protocol Command Reference : RIPng Commands
RIPng Commands
This chapter provides an alphabetized reference for each of the Routing Information Protocol next generation (RIPng) commands, which support IPv6. It includes the following commands:
route
aggregate-address
Use this command to set an aggregate RIPng route announcement.
Use the no parameter with this command to disable this feature.
Command Syntax
aggregate-address X:X::X:X/M
no aggregate-address X:X::X:X/M
Parameter
X:X::X:X/M
Specify an aggregate network (IPv6 address prefix and length).
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#aggregate-address 3ffe:8088::/32
 
(config)#router ipv6 rip
(config-router)#no aggregate-address 3ffe:8088::/32
cisco-metric-behavior
Use this command to enable or disable the metric update as Cisco.
Use the no parameter with this command to disable this feature.
Command Syntax
cisco-metric-behavior (enable|disable)
no cisco-metric-behavior
Parameters
enable
Enable updating the metric consistent with Cisco.
disable
Disable updating the metric consistent with Cisco.
Default
By default, the Cisco metric-behavior is disabled.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
This example shows how to enable the metric update behavior to be consistent with Cisco in the Router mode.
#configure terminal
(config)#router ipv6 rip
(config-router)#cisco-metric-behavior enable
 
clear ipv6 rip route
Use this command to clear specific data from the RIPng routing table.
Command Syntax
clear ipv6 rip route (X:X::X:X/M|rip|kernel|connected|static|ospf6|isis|bgp|all)
Parameters
X:X::X:X/M
Removes entries which exactly match this destination address from the RIPng routing table.
bgp
Removes only BGP routes from the RIP routing table.
connected
Removes entries for connected routes from the RIP routing table.
isis
Removes only IS-IS routes from the RIP routing table
kernel
Removes kernel entries from the RIP routing table.
ospf
Removes only OSPF routes from the RIP routing table.
static
Removes static entries from the RIP routing table.
all
Removes the entire RIP routing table.
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ipv6 rip route isis
#clear ipv6 rip route 3ffe:ffff::/16
debug ipv6 rip
Use this command to specify the options for the displayed debugging information for RIPng events, RIPng packets and RIPng NSM communications.
Use the no option with this command to turn off debugging options for RIPng. The undebug alias command can also be used.
Command Syntax
debug ipv6 rip (all|events|packet send|packet recv|packet|packet detail|nsm|rib|)
no debug ipv6 rip (all|events|packet send|packet recv|packet|packet detail|nsm|rib|)
undebug ipv6 rip (all|)
undebug ipv6 rip events
undebug ipv6 rip nsm
undebug ipv6 rip packet (recv|send|) (detail|)
undebug ipv6 rip rib
Parameters
all
Debug all RIP information.
events
Debug RIP events.
nsm
Debug RIP and NSM communications.
rib
Debug RIP and RIB communications.
packet
Debug RIP packets, only Routing Information Protocol
recv
Debug received packets.
send
Debug sent packets.
detail
Display detailed information for the sent or received packet.
Default
Disabled
Command Mode
Privileged Exec mode and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example specifies the options for the displayed debugging information in Configure mode prompt.
#configure terminal
(config)#debug ipv6 rip events
(config)#debug ipv6 rip packet send detail
(config)#debug ipv6 rip nsm
The following example shows to disable all debugging in Privileged Exec mode prompt.
#undebug ipv6 rip events
#undebug ipv6 rip packet send detail
#undebug ipv6 rip nsm
 
default-information originate
Use this command to generate a default route into the RIPng.
Use the no parameter with this command to disable this feature.
Command Syntax
default-information originate
no default-information originate
Parameters
None
Default
Disabled
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#default-information originate
default-metric
Use this command to specify the metrics to be assigned to redistributed routes.
Use the no parameter with this command to disable this feature.
For more details about this command, see the IPv4 version of this command (default-metric).
Command Syntax
default-metric <1-15>
no default-metric
Parameter
<1-15>
Specify the default metric.
Default
By default, the metric value is set to 1.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#default-metric 8
distance
Use this command to set the administrative distance for RIP.
Use the no option with this command to disable this function.
For more details about this command, see the IPv4 version of this command (distance).
Command Syntax
distance <1-255>
no distance
Parameter
<1-255>
Specify the administrative distance value.
Default
By default, the administrative distance is 120.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#router ipv6 rip
(config-router)#distance 100
 
distribute-list
Use this command to filter incoming or outgoing route updates using the access-list or the prefix-list. You can filter out incoming or outgoing route updates using access-list or 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.
Command Syntax
distribute-list WORD (in|out) (IFNAME|)
distribute-list prefix WORD (in|out) (IFNAME|)
no distribute-list (in|out) (IFNAME|)
no distribute-list prefix (in|out) (IFNAME|)
Parameters
WORD
Specify the IPv6 access-list number or name to use.
prefix
Filter prefixes in routing updates.
WORD
Specify the name of the IPv6 prefix-list to use.
in
Filter incoming routing updates.
out
Filter outgoing routing updates.
IFNAME
Specify the name of the interface on which distribute-list applies.
Default
Disabled
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.
Example
#configure terminal
(config)#router ipv6 rip
(config-router)#distribute-list prefix myfilter in eth0
 
ipv6 rip metric-offset
Use this command to set RIP metric offset.
Use the no parameter with this command to disable this function.
Command Syntax
ipv6 rip metric-offset <1-16>
no ipv6 rip metric-offset
Parameter
<1-16>
Set a metric value
Default
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 rip metric-offset 1
 
(config)#interface eth0
(config-if)#no ipv6 rip metric-offset
ipv6 rip split-horizon
Use this command to perform the split-horizon action on the interface.
Use the no parameter with this command to disable this function.
For more details about this command, see the IPv4 version of this command (ip rip split-horizon).
Command Syntax
ipv6 rip split-horizon
ipv6 rip split-horizon poisoned
no ipv6 rip split-horizon
Parameter
poisoned
Performs split-horizon with poisoned reverse.
Default
By default, Split horizon poisoned is enabled.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth1
(config-if)#ipv6 rip split-horizon
 
(config)#interface eth1
(config-if)#no ipv6 rip split-horizon
ipv6 router rip
Use this command to enable RIPng routing on the interface.
Use the no parameter with this command to disable RIPng routing.
Command Syntax
ipv6 router rip
no ipv6 router rip
Parameters
None
Default
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface eth0
(config-if)#ipv6 router rip
neighbor
Use this command to specify a neighbor router.
Use the no parameter with this command to disable the specific router.
For more details about this command, see the IPv4 version of this command (neighbor).
Command Syntax
neighbor X:X::X:X IFNAME
no neighbor X:X::X:X IFNAME
Parameters
X:X::X:X
Specify a link-local address of the peer router with which the routing information is exchanged.
IFNAME
Specify the name of the interface.
Default
Disabled
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#router ipv6 rip
(config-router)#neighbor fe80::5054:ff:fece:30cd eth1
(config-router)#end
#show running-config ripng
!
router ipv6 rip
neighbor fe80::5054:ff:fece:30cd eth1
!
#
 
#show ipv6 interface brief
Interface IPv6-Address Admin-Status
eth0 fe80::5054:ff:fe4e:22d3 [up/up]
eth1 2001:2001::1:2
fe80::5054:ff:fe5c:6a4f [up/up]
eth2 fe80::5054:ff:fe16:8339 [up/up]
eth3 fe80::5054:ff:feb9:bc7c [up/up]
lo ::1 [up/up]
offset-list
Use this command to add an offset to in and out metrics to routes learned through RIPng.
Use the no parameter with this command to remove this function.
For more details about this command, see the IPv4 version of this command (offset-list).
Command Syntax
offset-list WORD (in|out) (IFNAME|)
no offset-list in|out (IFNAME|)
Parameters
WORD
Specify the access-list number or names to apply.
in
Indicates the access list will be used for metrics of incoming advertised routes.
out
Indicates the access list will be used for metrics of outgoing advertised routes.
IFNAME
An alphanumeric string that specifies the interface to match.
Default
The default offset value is the metric value of the interface which is defined by the operating system.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3 and modified in OcNOS version 6.1.0.
Examples
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.
#configure terminal
(config)#router ipv6 rip
(config-router)#offset-list accesslist1 in eth0
 
passive-interface
Use this command to suppress routing updates on an interface.
Use the no parameter with this command to disable this function.
Command Syntax
passive-interface IFNAME
no passive-interface IFNAME
Parameters
IFNAME
Specify the interface name.
Default
Disabled
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#passive-interface eth0
 
recv-buffer-size
Use this command to run-time configure the RIPng UDP receive-buffer size.
Use the no parameter with this command to return to the default value.
Command Syntax
recv-buffer-size <8192-2147483647>
no recv-buffer-size
Parameters
<8192-2147483647>
 
Specify the RIP UDP receive buffer size value.
Default
The default value of the RIP UDP receive-buffer size is 8192.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#recv-buffer-size 150000
 
redistribute
Use this command to redistribute information from other routing protocols.
Use the no parameter with this command to disable this function.
Command Syntax
redistribute (kernel|connected|static|ospf|isis|bgp)
redistribute (kernel|connected|static|ospf|isis|bgp) metric <0-16>
redistribute (kernel|connected|static|ospf|isis|bgp) route-map WORD
redistribute (kernel|connected|static|ospf|isis|bgp) metric <0-16> route-map WORD
no redistribute (kernel|connected|static|ospf|isis|bgp)
no redistribute (kernel|connected|static|ospf|isis|bgp) metric <0-16>
no redistribute (kernel|connected|static|ospf|isis|bgp) route-map WORD
no redistribute (kernel|connected|static|ospf|isis|bgp) metric <0-16> route-map WORD
Parameters
bgp
Redistribute from BGP routes
connected
Redistribute from connected routes
isis
Redistribute from ISO IS-IS routes
kernel
Redistribute from kernel routes
ospf
Redistribute from OSPF routes (version 3)
static
Redistribute from static routes
metric
Metric value
<0–16>
Specify a metric value
route-map
Route map reference
WORD
Specify name of the route-map
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#redistribute kernel route-map mymap
(config-router)#redistribute kernel metric 8
route
Use this command to debug the specified route advertisement. Use this command to configure static RIPng routes.
Use the no parameter with this command to disable this function.
Command Syntax
route X:X::X:X/M
no route X:X::X:X/M
Parameter
X:X::X:X/M
Specify the IPv6 address prefix and length.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#route 3ffe:1234:5678::1/64
 
route-map
Use this command to set a route map for input or output filtering on a specified interface.
Use the no parameter with this command to disable this function.
Command Syntax
route-map WORD (in|out) IFNAME
no route-map (in|out) IFNAME
Parameters
WORD
Specify a route map name
in
Specify to set the route map for input filtering
out
Specify to set the route map for output filtering
IFNAME
Specify an interface name to which to associate the route map
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#route-map myRM in eth1
router ipv6 rip
Use this global command to enable a RIPng routing process.
Use the no parameter with this command to disable the RIPng routing process.
Command Syntax
router ipv6 rip
no router ipv6 rip
Parameters
None
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#
show debugging ipv6 rip
Use this command to display the RIPng debugging status for RIPng NSM, RIPng events, and RIPng packets.
Command Syntax
show debugging ipv6 rip
Parameters
None
Command Mode
Exec Mode and Privileged Exec Mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show debugging ipv6 rip
RIPng packet debugging is on
 
show ipv6 protocols rip
Use this command to display RIPng process parameters and statistics.
Command Syntax
show ipv6 protocols rip
Parameters
None
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following is a sample output from the show ipv6 protocols rip command.
#show ipv6 protocols rip
Routing Protocol is "ripng"
Sending updates every 30 seconds with +/-50%, next due in 10 seconds
Timeout after 180 seconds, garbage collect after 120 seconds
Outgoing update filter list for all interface is not set
Incoming update filter list for all interface is not set
Default redistribute metric is 1
Redistributing: connected
Routing for Networks:
3ffe:1::/64
#
show ipv6 rip
Use this command to show RIP routes.
Command Syntax
show ipv6 rip (database|)
Parameters
database
Specify to display information about the IPv6 RIP database.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following is a sample output from the show ipv6 rip database command.
#show ipv6 rip database
Codes: R - RIP, K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS,
B - BGP, a - aggregate, s - suppressed
Network Next Hop If Met Tag Time
R 3ffe:1234:5678::/64 fe80::3 eth1 3 0 02:28
C 3ffe:ffff:1::/64 :: eth0 1 0
Ra 3ffe:ffff:2::/48 -- 1 0
Rs 3ffe:ffff:2::/48 fe80::3 eth1 3 0 02:32
Cs 3ffe:ffff:2::/64 :: eth1 1 0
R 3ffe:ffff:ffff:ffff::/64 fe80::3 eth1 3 0 02:28
show ipv6 rip interface
Use this command to display information about the RIPng interfaces. You can specify an interface name to display information about a specific interface.
Command Syntax
show ipv6 rip interface (IFNAME|)
Parameters
IFNAME
Name of the interface for which information is to be displayed.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following is a sample output from the show ipv6 rip interface command.
#show ipv6 rip interface
lo is up, line protocol is up
RIPng is not enabled on this interface
eth0 is up, line protocol is up
RIPng is not enabled on this interface
eth1 is down, line protocol is down
RIPng is not enabled on this interface
eth2 is up, line protocol is up
Routing Protocol: RIPng
Passive interface: Disabled
Split horizon: Enabled with Poisoned Reversed
IP interface address:
3ffe:ffff::1/64
3ffe:fffe::1/64
 
timers basic
Use this command to adjust routing network timers.
Use the no parameter with this command to restore the defaults.
For more details about this command, see the IPv4 version of this command (timers basic).
Command Syntax
timers basic <5-2147483647> <5-2147483647> <5-2147483647>
no timers basic
Parameters
<5-2147483647>
Specify the routing table update timer in seconds. The default is 30 seconds.
<5-2147483647>
Specify the routing information timeout timer in seconds. The default is 180 seconds. After this interval has elapsed and no updates for a route are received, the route is declared invalid.
<5-2147483647>
Specify the routing garbage collection timer in seconds. The default is 120 seconds.
Command Mode
Router mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router ipv6 rip
(config-router)#timers basic 30 180 120
 
(config)#router ipv6 rip
(config-router)#no timers basic