-
Cisco IOS XR Routing Command Reference, Release 3.4
-
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 Language Commands on Cisco IOS XR Software
-
Static Routing Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
RIB Commands on Cisco IOS XR Software
address-family next-hop dampening disable
RIB Commands on Cisco IOS XR Software
This chapter describes the commands used to display and clear information in the Routing Information Base (RIB).
For detailed information about RIB concepts, configuration tasks, and examples, see Implementing RIB on Cisco IOS XR Software.
address-family next-hop dampening disable
To disable Routing Information Base (RIB) next-hop dampening, use the address-family next-hop dampening disable command in router configuration mode. To enable RIB next-hop dampening, use the no form of this command.
address-family {ipv4 | ipv6} next-hop dampening disable
no address-family {ipv4 | ipv6} next-hop dampening disable
Syntax Description
ipv4
Specifies IP Version 4 (IPv4) address prefixes.
ipv6
Specifies IP Version 6 (IPv6) address prefixes.
Defaults
RIB next-hop dampening is enabled.
Command Modes
Router configuration
Command History
Release 3.4.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 address-family next-hop dampening disable command to disable RIB next-hop dampening.
Task ID
Examples
The following example shows how to disable RIB next-hop dampening for IPv6 address families:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router ribRP/0/RP0/CPU0:router(config-rib)# address-family ipv6 next-hop dampening disableclear route
To clear routes from the IP routing table, use the clear route command in EXEC mode.
clear route [vrf {vrf-name | all}] {ipv4 | ipv6 | afi-all} {unicast | multicast | safi-all} [ip-address mask]
Syntax Description
Defaults
If a vrf vrf-name is not specified, routes are cleared from the default IPv4 unicast VRF.
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 route command to clear routes from an IP routing table to a specific network, a matching subnet address, or all routes.
Task ID
Examples
The following example shows how to remove all routes matching the subnet address 192.168.2.0 and mask 255.255.255.0 from the IPv4 unicast routing table:
RP/0/RP0/CPU0:router# clear route ipv4 unicast 192.168.2.0 255.255.255.0The following example shows how to remove all routes from the IPv4 unicast routing table:
RP/0/RP0/CPU0:router# clear route ipv4 unicastRelated Commands
maximum prefix (RIB)
To set the prefix limit for the VPN routing and forwarding (VRF) instance, use the maximum prefix command in global VRF address family configuration mode. To set the prefix limits to the default values, use the no form of this command.
maximum prefix maximum [mid-threshold]
no maximum prefix
Syntax Description
Command Modes
Global VRF address family configuration
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
No modification.
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 maximum prefix command to configure a maximum number of prefixes that a VRF instance is allowed to receive.
Task ID
Examples
The following example shows how to set the maximum number of prefixes allowed to 1000:
RP/0/RP0/CPU0:router(config)# vrf vrf-ARP/0/RP0/CPU0:router(config-vrf)# address-family ipv4 unicastRP/0/RP0/CPU0:router(config-vrf-af)# maximum prefix 1000Related Commands
router rib
To enter Routing Information Base (RIB) configuration mode, use the router rib command in global configuration mode. To remove all RIB configurations and terminate the RIB routing process, use the no form of this command.
router rib
no router rib
Syntax Description
This command has no arguments or keywords.
Defaults
Router configuration mode is not enabled.
Command Modes
Global configuration
Command History
Release 3.4.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 router rib command to enter RIB configuration mode.
Task ID
Examples
The following example shows how to enter RIB configuration mode:
RP/0/RP0/CPU0:router(config)# router ribshow rib client-id
To display Routing Information Base (RIB) redistribution histories, use the show rib client-id command in EXEC mode.
show rib client-id id redistribution history [standby]
Syntax Description
id
ID of the client. Range is 0 to 4294967295.
redistribution history
Displays longer history of redistributed routes sent to RIB clients.
standby
(Optional) Displays standby information.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
The standby keyword was added.
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 show rib client-id command to display a history of the route additions, deletions, and updates sent from RIB to the client across all VRFs.
Task ID
Examples
The following is sample output from the show rib client-id command:
RP/0/RP0/CPU0:router# show rib client-id 13 redistribution historyPID JID Client Location151630 113 bcdl_agent node0_5_CPU0Table ID: 0xe0000000S 80.80.80.0/24[1/0] update, 5 path(s), 0x0 Jan 31 09:54:57.224S 80.80.80.0/24[1/0] update, 6 path(s), 0x0 Jan 31 09:53:39.736S 140.140.140.0/24[1/0] update, 1 path(s), 0x0 Jan 31 09:53:39.729S 80.80.80.0/24[1/0] update, 5 path(s), 0x0 Jan 30 22:08:38.551S 140.140.140.0/24 deleted, Jan 30 22:08:38.543S 80.80.80.0/24[1/0] update, 6 path(s), 0x0 Jan 30 22:03:05.889S 100.100.100.0/24[1/0] update, 1 path(s), 0x0 Jan 30 22:03:05.880Table 129 describes the significant fields shown in the display.
Table 129 show rib client-id Field Descriptions
PID
Process ID of the client.
JID
Job ID of the client.
Client
Client name.
Location
Location node on which the client is present.
Related Commands
show rib clients
To display Routing Information Base (RIB) clients, use the show rib clients command in EXEC mode.
show rib [afi-all | ipv4 | ipv6] clients [protocols | redistribution [history]] [standby]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
The ipv4, ipv6, and standby keywords were added.
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 show rib clients command to display the list of clients who have registered with RIB, what protocol routes they are redistributing, and a history of the routes sent to the client.
The maximum number of redistribution entries is 5000 for Bulk Content Downloader (BDCL) and 500 for other protocols.
Task ID
Examples
The following is sample output from the show rib clients command:
RP/0/RP0/CPU0:router# show rib clientsProcess Location Client ID Redist Protoisis node0_5_CPU0 0 insync insyncospf node0_5_CPU0 2 insync insyncRP/0/RP0/CPU0:router# show rib clients redistributionisis node0_5_CPU0ipv4 uni vrf default insync routestatic insyncospf node0_5_CPU0ipv4 uni vrf default insync routestatic insynclocal insyncbgp node0_5_CPU0ipv4 uni vrf abc insync routestatic insyncbcdl_agent node0_5_CPU0ipv4 uni vrf default insync rib_fibipv4 uni vrf bar insync rib_fibipv4 uni vrf abc insync rib_fibipv4 uni vrf test insync rib_fibTable 130 describes the significant fields shown in the display.
show rib extcomms
To display all extended communities installed in the Routing Information Base (RIB), use the show rib extcomms command in EXEC mode.
show rib [afi-all | ipv4 | ipv6] extcomms [summary] [standby]
Syntax Description
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
The ipv4, ipv6, and standby keywords were added.
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 show rib extcomms command to display extended communities installed in the RIB.
Task ID
Examples
The following is sample output from the show rib extcomms command:
RP/0/RP0/CPU0:router# show rib extcommsExtended community data in RIB:Extended community Ref countCOST:128:128:41984 1EIGRP route-info:0x8000:0 1EIGRP AD:1:25600 1EIGRP RHB:255:0:16384 1EIGRP LM:0x0:1:4470 1Table 131 describes the significant fields shown in the display.
show rib firsthop
To display registered first-hop notification addresses, use the show rib firsthop command in EXEC mode.
show rib [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] firsthop [interface-type interface-instance | ip-address /prefix-length | ip-address mask | resolved | unresolved | looped | damped | tunnel-ipsec | tunnel-te] [summary] [standby]
Syntax Description
Command Default
If a vrf vrf-name is not specified, the registered first-hop notifications addresses are displayed for the default IPv4 unicast VRF.
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 show rib firsthop command to display the list of next hops registered by various clients with RIB and the address and interface through which they are resolved.
Task ID
Examples
The following is sample output from the show rib firsthop command:
RP/0/RP0/CPU0:router# show rib firsthopRegistered firsthop notifications:0.0.0.0/0 via 1.1.0.1 - MgmtEth0/5/CPU0/0, ospf/node0_5_CPU01.1.0.1/32 via 1.1.0.1 - MgmtEth0/5/CPU0/0, ipv4_static/node0_5_CPU01.1.1.1/32 via 1.1.1.1 - MgmtEth0/5/CPU0/0, ipv4_static/node0_5_CPU010.10.10.1/32 via 10.10.10.1 - Loopback0, ipv4_static/node0_5_CPU010.10.10.3/32 via 10.10.10.3 - Loopback0, ipv4_static/node0_5_CPU015.15.15.1/32 via 10.10.10.1 - Loopback0, ipv4_static/node0_5_CPU020.20.20.1/32 via 1.1.1.1 - MgmtEth0/5/CPU0/0, ipv4_static/node0_5_CPU030.30.30.1/32 via 1.1.1.2 - MgmtEth0/5/CPU0/0, ipv4_static/node0_5_CPU0show rib history
To display history information for Routing Information Base (RIB) clients, use the show rib history command in EXEC mode.
show rib [afi-all | ipv4 | ipv6] history [client-id client-id] [standby]
Syntax Description
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
The standby keyword was added.
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 show rib history command to display the list of routes that RIB has sent to various clients.
Task ID
Examples
The following is sample output from the show rib history command:
RP/0/RP0/CPU0:router# show rib historyJID Client Location229 isis node0_5_CPU0Table ID: 0xe0000000S 80.80.80.0/24[1/0] update, 6 path(s), 04:32:09S 100.100.100.0/24[1/0] update, 1 path(s), 04:32:09S 40.40.40.0/24[1/0] update, 1 path(s), 04:32:09S 15.15.15.0/24[1/0] update, 1 path(s), 04:32:09JID Client Location260 ospf node0_5_CPU0Table ID: 0xe0000000S 80.80.80.0/24[1/0] update, 6 path(s), 04:32:09S 100.100.100.0/24[1/0] update, 1 path(s), 04:32:09S 40.40.40.0/24[1/0] update, 1 path(s), 04:32:09S 15.15.15.0/24[1/0] update, 1 path(s), 04:32:09Table 132 describes the significant fields shown in the display.
Table 132 show rib history Field Descriptions
JID
Job ID of the client process.
Client
Name of the client process.
Location
Information about where the client process is running.
show rib protocols
To display protocols registered for route addition, use the show rib protocols command in EXEC mode.
show rib [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] protocols [standby]
Syntax Description
Command Default
If a vrf vrf-name is not specified, the registered first-hop notification addresses are displayed for the default IPv4 unicast VRF.
Command Modes
EXEC
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
The all and standby keywords were added.
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 show rib protocols command to display registered protocols.
Task ID
Examples
The following is sample output from the show rib protocols command:
RP/0/RP0/CPU0:router# show rib protocolsProtocol Handle Instanceisis 0 ribconnected 1static 2local 3bgp 4 102ospf 5 1Table 133 describes the significant fields shown in the display.
Table 133 show rib protocols Field Descriptions
Protocol
Name of the protocol.
Handle
Handle assigned to the protocol instance.
Instance
Protocol instance.
show rib statistics
To display Routing Information Base (RIB) statistics, use the show rib statistics command in EXEC mode.
show rib [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] statistics [client-name] [standby]
Syntax Description
Command Default
If vrf vrf-name is not specified, the registered first-hop notification addresses are displayed for the default IPv4 unicast VRF.
Command Modes
EXEC
Command History
Release 3.4.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 show rib statistics command to display RIB statistics. The statistics include requests sent from the clients to the RIB and the information redistributed to the client.
RIB maintains counters for all requests sent from a client including:
•
Route operations
•
•
•
•
•
RIB also maintains the results of the requests.
Task ID
Examples
The following is sample output from the show rib statistics command:
RP/0/RP0/CPU0:router# show rib statisticsRIB Statistics:Received 142 batch messages137 route operations, 0 attribute operations11 complete operations, 0 convergent operationsResults of the batch message received:142 successes0 forward references, 0 invalid client id, 0 unknown errors0 memory allocation errors, 0 client lookup errors, table lookup errors 00 proto lookup errors, 0 client proto lookup errorsipv4_connected/node0_RP0_CPU0 last performed route operationwith status BATCH_SUCESS at Jun 26 21:43:33.601Received 217422 light weight messages4 route add requests, 2 route delete requests10 protocol registered, 1 protocol unregistered0 protocol modify, 0 protocol purged14 protocol redistributions, 0 unregistered protocol redistributions0 reset protocol redistributions3 first hop registered, 1 first hop unregistered3 advertisements, 0 unregistered advertisement57 bind data, 97 update completes, 217230 other requestsudp/node0_RP0_CPU0 last performed firsthop lookup operationwith status success at Jun 27 10:09:59.990Received 0 nexthop batch messages0 successes0 inits0 registers, 0 unregisters0 register complete, 0 sync unregistered, 0 batch finishedTable 134 describes the significant fields shown in the display.
show rib tables
To display all tables known to the Routing Information Base (RIB), use the show rib tables command in EXEC mode.
show rib [afi-all | ipv4 | ipv6] tables [standby]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.3.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.4.0
The ipv4, ipv6, and standby keywords were added.
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 show rib tables command to display all tables known to the RIB, including table attributes. Attributes include VPN routing and forwarding (VRF) instance, address family, and maximum prefix information.
Task ID
Examples
The following is sample output from the show rib tables command when entered without an address:
RP/0/RP0/CPU0:router# show rib tablesVRF AFI/SAFI Table ID PrfxLmt PrfxCount PrfxLmtNotified FwdRfrncd Deleteddefault ipv4/uni 0xe0000000 2000000 3 No No Novrf_A ipv4/uni 0xe0000001 2000000 0 No No Nodefault ipv4/multi 0xe0100000 2000000 0 No No NoTable 135 describes the significant fields shown in the display.
show route
To display the current routes in the Routing Information Base (RIB), use the show route command in EXEC mode.
show route [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] [protocol [instance] | ip-address [mask] | ip-address/prefix-length] [standby] [detail]
Syntax Description
Defaults
If a vrf vrf-name is not specified, routes are displayed for the default IPv4 unicast VRF.
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.
When the afi-all keyword is used, the ip-address and mask arguments are not available.
Task ID
Examples
The following is sample output from the show route command when entered without an address:
RP/0/RP0/CPU0:router# show routeCodes: C - connected, S - static, R - RIP, M - mobile, B - BGPD - EIGRP, EX - EIGRP external, O - OSPF, IA - OSPF inter areaN1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2E1 - OSPF external type 1, E2 - OSPF external type 2, E - EGPi - ISIS, L1 - IS-IS level-1, L2 - IS-IS level-2ia - IS-IS inter area, su - IS-IS summary null, * - candidate defaultU - per-user static route, o - ODR, L - localGateway of last resort is 1.0.0.1 to network 0.0.0.0S* 0.0.0.0/0 [1/0] via 1.0.0.1, 13:14:59C 1.0.0.0/16 is directly connected, 13:14:59, MgmtEth0/5/CPU0/0L 1.0.14.15/32 is directly connected, 13:14:59, MgmtEth0/5/CPU0/0C 3.2.3.0/24 is directly connected, 00:04:39, POS0/3/0/0L 3.2.3.2/32 is directly connected, 00:04:39, POS0/3/0/0O E2 5.2.5.0/24 [110/20] via 3.3.3.1, 00:04:20, POS0/3/0/0O E2 6.2.6.0/24 [110/20] via 3.3.3.1, 00:04:20, POS0/3/0/0C 7.2.7.0/24 is directly connected, 00:04:20, POS0/3/0/7L 7.2.7.2/32 is directly connected, 00:04:20, POS0/3/0/7O E2 8.2.8.0/24 [110/20] via 3.3.3.1, 00:04:20, POS0/3/0/0C 10.3.0.0/16 is directly connected, 13:14:59, GigabitEthernet0/0/0/0L 10.3.0.2/32 is directly connected, 13:14:59, GigabitEthernet0/0/0/0Table 136 describes the significant fields shown in the display.
When you specify that you want information about a specific network, more detailed statistics are displayed. The following is sample output from the show route command when entered with an IP address:
RP/0/RP0/CPU0:router# show route 10.0.0.0Routing entry for 10.0.0.0/16Known via "connected", distance 0, metric 0 (connected)Installed Mar 22 22:10:20.906Routing Descriptor Blocksdirectly connected, via GigabitEthernet0/0/0/0Route metric is 0No advertising protos.Intermediate System-to-Intermediate System (IS-IS) includes an IP address typed length value (TLV) in its link-state packet (LSP) that helps identify the node injecting the route into the network. The IS-IS node uses one of its own interface addresses in this TLV. A loopback address is preferred among interfaces configured under IS-IS. When other networking devices calculate IP routes, they can store the this IP address as the originator address with each route in the routing table.
The following example shows the output from the show route command for a specific IP address on a router configured with IS-IS. Each path that is shown under the Routing Descriptor Blocks report displays two IP addresses. The first address (10.0.0.9) is the next hop address; the second is the originator IP address from the advertising IS-IS router.
RP/0/RP0/CPU0:router# show route 10.0.0.1Routing entry for 10.0.0.0/8Known via "isis", distance 115, metric 10, type level-2Installed Jan 22 09:26:56.210Routing Descriptor Blocks:* 10.0.0.9, from 10.0.0.9, via GigabitEthernet2/1Route metric is 10No advertising protos.Table 137 describes the significant fields shown when the show route command is used with an IP address (previous displays).
Related Commands
show interfaces
Lists interface information.
Displays the current contents of the routing table in summary format.
show route backup
To display backup routes from the Routing Information Base (RIB), use the show route backup command in EXEC mode.
show route [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] backup [ip-address [mask] | ip-address/prefix-length] [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the backup routes from the RIB are displayed for the default IPv4 unicast VRF.
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 show route backup command to display information about routes that have been installed into the RIB as backup routes. This command also displays information about the currently selected active route for which there is a backup.
When the afi-all keyword is used, the ip-address and mask arguments are not available.
Task ID
Examples
The following is sample output from the show route backup command:
RP/0/RP0/CPU0:router# show route backupCodes: C - connected, S - static, R - RIP, M - mobile, B - BGPD - EIGRP, EX - EIGRP external, O - OSPF, IA - OSPF inter areaN1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2E1 - OSPF external type 1, E2 - OSPF external type 2, E - EGPi - ISIS, L1 - IS-IS level-1, L2 - IS-IS level-2ia - IS-IS inter area, su - IS-IS summary null, * - candidate defaultU - per-user static route, o - ODR, L - localS 172.73.51.0/24 is directly connected, 2d20h, POS4/0/0/1Backup O E2 [110/1] via 10.12.12.2, POS3/0/0/1Table 138 describes the significant fields shown in the display.
Related Commands
show route best-local
To display the best local address to use for return packets from the given destination, use the show route best-local command in EXEC mode.
show route [vrf {vrf-name | all}] [ipv4 | ipv6] [unicast | multicast | safi-all] best-local ip-address [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the best local address is displayed for the default IPv4 unicast VRF.
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 show route best-local command to display information about the best local routes in the routing table.
Task ID
Examples
The following is sample output from the show route best-local command:
RP/0/RP0/CPU0:router# show route best-local 10.12.12.1/32Routing entry for 10.12.12.1/32Known via "local", distance 0, metric 0 (connected)Routing Descriptor Blocks10.12.12.1 directly connected, via POS3/0/0/1Route metric is 0Table 139 describes the significant fields shown in the display.
Related Commands
show route connected
To display the current connected routes of the routing table, use the show route connected command in EXEC mode.
show route [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] connected [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the current connected routes of the routing table are displayed for the default IPv4 unicast VRF.
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 show route connected command to display information about connected routes in the routing table.
Task ID
Examples
The following is sample output from the show route connected command:
RP/0/RP0/CPU0:router# show route connectedC 1.68.0.0/16 is directly connected, 13:43:40, MgmtEth0/5/CPU0/0C 3.3.3.0/24 is directly connected, 00:23:23, POS0/3/0/0C 7.7.7.0/24 is directly connected, 00:33:00, POS0/3/0/7C 10.0.0.0/16 is directly connected, 13:43:40, GigabitEthernet0/0/0/0C 10.10.10.0/30 is directly connected, 13:43:40, Loopback0C 11.11.11.0/24 is directly connected, 13:43:40, Loopback11Table 140 describes the significant fields shown in the display.
Related Commands
show route local
To display local routes receiving routing updates from the Routing Information Base (RIB), use the show route local command in EXEC mode.
show route [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] local [interface-type interface-instance] [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the local routes receiving updates from the RIB are displayed for the default IPv4 unicast VRF.
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 show route local command to display information about local routes in the routing table.
Task ID
Examples
The following is sample output from the show route local command:
RP/0/RP0/CPU0:router# show route localL 10.10.10.1/32 is directly connected, 00:14:36, Loopback0L 10.91.36.98/32 is directly connected, 00:14:32, POS6/0/0/1L 172.22.12.1/32 is directly connected, 00:13:35, POS3/0/0/1L 192.168.20.2/32 is directly connected, 00:13:27, POS4/0/0/1L 10.254.254.1/32 is directly connected, 00:13:26, POS5/0/0/1Table 141 describes the significant fields shown in the display.
Related Commands
Displays information about all clients that have registered with the RIB as protocols.
show route longer-prefixes
To display the current routes in the Routing Information Base (RIB) that share a given number of bits with a given network, use the show route longer-prefixes command in EXEC mode.
show route [vrf {vrf-name | all}] [ipv4 | ipv6] [unicast | multicast | safi-all] longer-prefixes {ip-address mask | ip-address/prefix-length} [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the current routes in the RIB sharing a specified number of bits with a network are displayed for the default IPv4 unicast VRF.
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 show route longer-prefixes command to troubleshoot forwarding problems whose cause may be a long prefix.
Task ID
Examples
The following is sample output from the show route longer-prefixes command:
RP/0/RP0/CPU0:router# show route ipv4 172.16.0.0/8 longer-prefixesS 172.16.2.0/32 is directly connected, 00:00:24, Loopback0S 172.16.3.0/32 is directly connected, 00:00:24, Loopback0S 172.16.4.0/32 is directly connected, 00:00:24, Loopback0S 172.16.5.0/32 is directly connected, 00:00:24, Loopback0S 172.16.6.0/32 is directly connected, 00:00:24, Loopback0S 172.16.7.0/32 is directly connected, 00:00:24, Loopback0S 172.16.8.0/32 is directly connected, 00:00:24, Loopback0S 172.16.9.0/32 is directly connected, 00:00:24, Loopback0Table 142 describes the significant fields shown in the display.
Related Commands
router static
Establishes a static route.
show interfaces
Lists interface information.
Displays the current contents of the routing table in summary format.
show route next-hop
To filter routes by nexthop address or interface, use the show route next-hop command in EXEC mode.
show route [vrf {vrf-name | all}] [ipv4 | ipv6] [unicast | multicast | safi-all] next-hop ip-address [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the next-hop gateway or host is displayed for the default IPv4 unicast VRF.
Command Modes
EXEC
Command History
Release 3.4.0
Function of this command was changed. See the show route resolving-next-hop command.
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 show route next-hop command find all routes going through a nexthop address or interface.
Task ID
Examples
The following is sample output from the show route next-hop command filtering routes on the nexthop address:
RP/0/RP0/CPU0:router# show route next-hop 1.68.0.1Codes: C - connected, S - static, R - RIP, M - mobile, B - BGPD - EIGRP, EX - EIGRP external, O - OSPF, IA - OSPF inter areaN1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2E1 - OSPF external type 1, E2 - OSPF external type 2, E - EGPi - ISIS, L1 - IS-IS level-1, L2 - IS-IS level-2ia - IS-IS inter area, su - IS-IS summary null, * - candidate defaultU - per-user static route, o - ODR, L - localGateway of last resort is 1.68.0.1 to network 0.0.0.0S* 0.0.0.0/0 [1/0] via 1.68.0.1, 15:01:49S 223.255.254.254/32 [1/0] via 1.68.0.1, 15:01:49The following is sample output from the show route next-hop command filtering routes on the nexthop interface:
RP/0/RP0/CPU0:router# show route next-hop GigabitEthernet 0/1/0/2Codes: C - connected, S - static, R - RIP, M - mobile, B - BGPD - EIGRP, EX - EIGRP external, O - OSPF, IA - OSPF inter areaN1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2E1 - OSPF external type 1, E2 - OSPF external type 2, E - EGPi - ISIS, L1 - IS-IS level-1, L2 - IS-IS level-2ia - IS-IS inter area, su - IS-IS summary null, * - candidate defaultU - per-user static route, o - ODR, L - localGateway of last resort is 1.68.0.1 to network 0.0.0.0C 11.1.1.0/24 is directly connected, 15:01:46, GigabitEthernet0/1/0/2L 11.1.1.2/32 is directly connected, 15:01:46, GigabitEthernet0/1/0/2Related Commands
show route resolving-next-hop
To display the next-hop gateway or host to a destination address, use the show route resolving-next-hop command in EXEC mode.
show route [vrf {vrf-name | all}] [ipv4 | ipv6] [unicast | multicast | safi-all] resolving-next-hop ip-address [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the next-hop gateway or host is displayed for the default IPv4 unicast VRF.
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 show route resolving-next-hop command to perform a recursive route lookup on the supplied destination address and return information on the next immediate router (next hop) to the destination.
Task ID
Examples
The following is sample output from the show route resolving-next-hop command:
RP/0/RP0/CPU0:router# show route resolving-next-hop 10.1.1.1Nexthop matches 10.1.1.1/32Known via "local", distance 0, metric 0 (connected)Installed Aug 22 01:57:08.514Directly connected nexthops10.1.1.1 directly connected, via Loopback0Route metric is 0Table 143 describes the significant fields shown in the display.
Table 143 show route resolving-next-hop Field Descriptions
Known via
Name of the routing protocol that installed the matching route.
Route metric is
Metric of the route.
Related Commands
show route static
To display the current static routes of the Routing Information Base (RIB), use the show route static command in EXEC mode.
show route [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] static [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the current static routes of the RIB are displayed for the default IPv4 unicast VRF.
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 show route static command to display information about static routes in the routing table.
Task ID
Examples
The following is sample output from the show route static command:
RP/0/RP0/CPU0:router# show route staticS 10.1.1.0/24 is directly connected, 00:54:05, POS3/0/0/1S 192.168.99.99/32 [1/0] via 10.12.12.2, 00:54:04Table 144 describes the significant fields shown in the display.
Related Commands
show route summary
To display the current contents of the Routing Information Base (RIB), use the show route summary command in EXEC mode.
show route [vrf {vrf-name | all}] [afi-all | ipv4 | ipv6] [unicast | multicast | safi-all] summary [detail] [standby]
Syntax Description
Defaults
If a vrf vrf-name is not specified, the contents of the RIB are displayed for the default IPv4 unicast VRF.
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 show route summary command to display information about routes in the routing information base.
When a route summary is needed frequently—for instance, in a polling manner—use the show route summary command without the detail keyword. The detail keyword is used less frequently for verification purposes, because it is much more expensive (in bandwidth), requiring a scan of the entire routing database.
Task ID
Examples
The following is sample output from the show route summary command:
RP/0/RP0/CPU0:router# show route summaryRoute Source Routes Backup Deleted Memory (bytes)static 1 0 0 136connected 2 1 0 408local 3 0 0 408ospf 1673 2 0 272isis 2 0 0 272Total 10 1 0 1496The following is sample output from the show route summary command with the detail keyword:
RP/0/RP0/CPU0:router# show route summary detailRoute Source Active Route Active Path Backup Route Backup Pathstatic 1 1 0 0connected 2 2 1 1local 3 3 0 0isis 1 1 1 1Level 1: 0 0 1 1Level 2: 1 1 0 0ospf 1673 6 12 0 0Intra-Area: 3 6 0 0Inter-Area: 3 6 0 0External-1: 0 0 0 0External-2: 0 0 0 0bgp 100 10 20 4 8External: 5 10 4 8Internal: 5 10 0 0local: 0 0 0 0Total 7 7 2 2Table 145 describes the significant fields shown in the display.
Related Commands