display route
Purpose
Required permissions
For Digi products with two or more users, permissions must be set to set permissions display=execute to use this command. See set permissions for details on setting user permissions for commands.
Syntax
display route
Examples
#> display route Route Table: Destination Gw Refs Mhome Iface mtu hops ttl flags 0.0.0.0/0 10.8.1.1 2 0 eth0 1500 1 INF UGS 10.8.0.0/16 * 1 0 eth0 1500 0 INF UC 127.0.0.0/8 127.0.0.1 1 0 LOOPBACK 1500 1 INF UGJS 127.0.0.1/32 127.0.0.1 4 0 LOOPBACK 1500 0 INF UH
Output
Destination
The destination IP address or subnetwork for a routing table entry. 0.0.0.0 is the “default gateway” entry, meaning it is the entry used to reach a destination for which there is no other (more suitable) route. The value following the / (for example, 16 in 10.8.0.0/16) specifies the subnet for that destination. 16 is a subnet mask of 255.255.0.0.
Gw
The gateway IP address to which a packet is forwarded to reach the destination. This is the first “hop” if the destination is on a subnet that is not immediate to the Digi device. The gateway value * (asterisk) means that the destination can be reached by sending the packets out the interface associated with the route.
Mhome
Multihome index on the configured interface.
Iface
The name of the local network interface associated with the route.
mtu
The Maximum Transmit Unit (MTU) size of the packets that are sent through the interface associated with the route. This size includes all octets of the packet starting with the IP header, or more generally, the maximum number of octets that can follow the datalink header (for example, Ethernet, PPP, and so on).
hops
The number of “hops” (intermediate routers) between the Digi device and the destination. Also referred to as the “metric”. This value is generally not useful other than to indicate that the destination is on a subnet that is not local to the Digi device.
ttl
The Time To Live (TTL) for the IP packets. For each “hop” that a packet takes in being forwarded to its destination, the TTL value in its IP header is decremented by one. If the TTL reaches zero, the packet is discarded. This prevents routing loops where a packet is routed indefinitely among routers in an IP network (or the Internet). The value INF means that the lifetime of the IP packets is infinite.
flags
Routing flags that indicate the nature of the routing table entry.
Flag |
Indication |
U |
Route is up. If not set, route is down. |
H |
Target is a host. If not set, target is a network |
G |
Use gateway. If not set, target is directly connected. |
D |
Dynamically installed by daemon or redirect. If not set, the routing entry is created statically. |
J |
Output through this route rejected |
C |
Entry can be cloned. |
L |
Cloned entry |
S |
Static entry configured by a user. |