IP CLI Commands
294
2/1553-ZAT 759 94 Uen B – December 2005
12.37
ip add route
12.37.1 Syntax
ip add route <name> <dest_ip> <netmask> {[gateway
<gateway_ip>]|[interface <interface>]}
12.37.2 Description
This command creates a static route to a destination network address via a
gateway device or an existing interface. It also allows you to create a default
route.
Note:
You can only create one default route. A default route will
not
be
created if you have already created a default route using the
ip add
route
command or the
ip add defaultroute interface
command.
A route specifies a destination network (or single host), together with a mask
to indicate what range of addresses the network covers, and a next-hop
gateway address or interface. If there is a choice of routes for a destination,
the route with the most specific mask is chosen.
Routes are used when sending datagrams as well as forwarding them, so they
are not relevant only to routers. However, a system with a single interface is
likely to have a single route as a default route to the router on the network that
it most often needs to use.
Usually, the user would specify either a gateway IP address or an interface IP
address, but not both. Routes via an interface can only be used on interfaces
that provide point-to-point links.
12.37.3 Options
The following table gives the range of values for each option which can be
specified with this command and a default value (if applicable).
