NAME

na.iproutes - routing table statistics

DESCRIPTION

na.iproutes reports routing table statistics. By default the agent reads /vmunix to get the kernel namelist.

A reporting interval is specified by the management application. If a reporting interval is not specified, the agent will send reports every 30 seconds.

ATTRIBUTES

na.iproutes has one attribute group, stats, and one attribute table, routes.

The stats group reports routing statistics. (The stats group supported by OS 4.x only.)

bad - number of bad routing redirects (counter)

dynamic - number of dynamically created routes (counter)

new_gw - number of routes modified due to redirects (counter)

dest_un - number of destinations found unreachable (counter)

wild - number of uses of a wildcard route (counter)

The routes table accepts a destination network name, destname, as a key and returns the routing table entry for that destination. If no key is specified, the entire routing table is returned. This table may be quite long for machines in large networks.

destname - destination name (string[32])

destaddr - destination address (inetaddr)

gwname - gateway name (string[32])

gwaddr - gateway address (inetaddr)

flags - status of route. (string[10])

U - Up

G - route is to a gateway

H - route is to a host

D - route was dynamically created due to a redirect

uses - number of active uses (gauge)

opkts - number of output packets sent (counter)

ifname - interface name (string[5])

metric - pseudo-cost or hop count routing metric (gauge)

OPTIONS

The SunOS 4.x rersion accepts one option: the name of an alternate file to use to get the kernel namelist.

The SunOS 5.x version accepts no options.

ERRORS

can't read kernel memory

The agent uid does not have permission to read kernel memory, /dev/kmem. Run the agent as root (default case if agent started by inetd (1M) ), or give read

permission to the uid the agent is running under.

The error message can also occur if the agent can't find or read the file containing the kernel namelist.