ip route

Last Updated : Oct 26, 2015 |
Establishes a static route. Use no ip route to remove a static route.
Prolog information
Metadata
Keywords:

Syntax

ip route ip_addr mask {{next_hop [next_hop [next_hop]] } | {interface_type interface_number}} [cost] [preference] [permanent | {track track-index} | Null0]
Note:
You can specify up to three next hops. However, if you apply tracking, you can specify only one next hop.
If you wish to establish a route through the FastEthernet interface on which DHCP address negotiation is configured, you must specify the interface type as the FastEthernet interface.
When applying tracking to a static route, a PBR next hop, or the DHCP client default route, you must specify the same next hop for the object tracker’s RTR (use the next hop command in rtr context).
Object tracking cannot be configured on Null0 or on a permanent route.

Parameters

Parameter
Description
Possible Values
Default Value
ip_addr
The IP address of the network
mask
The mask of the static route
next_hop
The next hop address in the network
interface_type
The interface type
interface_number
The interface number
cost
The path cost
1
preference
The preference of the route
High, Low
Low
permanent
Keyword that specifies that the route is not disabled if the interface is down
track
Keyword specifying to apply tracking to monitor the route
track-index
The index number of the object tracker
1-50
Null0
Keyword that creates a static discard route.
Note:
Object tracking cannot be configured on Null0 or on a permanent route.

User level

read-write

Context

general

Examples

To create a static route on IP address 132.55.0.0 with subnet mask 255.255.0.0 following the path 132.55.4.45, with cost of 3, priority of high, and object tracker 6:
Gxxx-001(super)# ip route 132.55.0.0 255.255.0.0 132.55.4.45 3 high track 6
To create a static discard route on IP address 134.66.0.0:
Gxxx-001(super)# ip route 134.66.0.0 255.255.0.0 Null0
To create a static route over the WAN Fast Ethernet when running DHCP client:
Gxxx-001# ip route 1.1.1.0 255.255.255.0 FastEthernet