display route

Purpose

Displays Route Table entries.

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.

See also

set forwarding