NAME

na.hostif - interface statistics

DESCRIPTION

na.hostif returns information about the interfaces that send IP packets on the host where the agent runs. 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 a report every 30 seconds.

ATTRIBUTES

na.hostif has one attribute table, if , that reports statistics on a particular interface, using name (le0,...) as the key. If no key is specified, statistics on all interfaces are reported.

If the named interface does not support a particular attribute (for example, an X.25 interface does not have an ipadrr), na.hostif returns no information for that attribute.

name - interface device name (string[32])

etheraddr - MAC-level address (string[20])

mtu - maximum transfer unit (short)

flags - interface information flags (short)

The agent returns flags in decimal, not hexadecimal, notation. Convert the value to hexadecimal and decode it according to the bit assignments shown below.

IFF_UP                  0x1     /* interface is up * /
IFF_BROADCAST           0x2     /* broadcast address valid * /
IFF_DEBUG               0x4     /* turn on debugging * /
IFF_LOOPBACK            0x8     /* is a loopback net * /
IFF_POINTOPOINT         0x10    /* interface is point-to-point link * /
IFF_NOTRAILERS          0x20    /* avoid use of trailers * /
IFF_RUNNING             0x40    /* resources allocated * /
IFF_NOARP               0x80    /* no address resolution protocol * /
IFF_PROMISC             0x100   /* receive all packets * /
IFF_ALLMULTI            0x200   /* receive all multicast packets * /
IFF_PRIVATE             0x8000 /* do not advertise * /

ipkts - cumulative number of packets received since system boot (counter)

ierrs - cumulative number of input errors since system boot (counter)

opkts - cumulative number of packets sent since system boot (counter)

oerrs - cumulative number of output errors since system boot (counter)

colls - cumulative number of collisions since system boot (counter)

qlen - current output queue length (gauge)

metric - (SunOS 4.x only) current hop count or pseudo-cost routing metric (gauge)

ipaddr - local IP address (inetaddr)

ipname - local IP name (string[32])

ipdest - IP network or destination address (inetaddr)

ipdestname - IP network or destination name (string [32])

netmask - IP subnet mask (inetaddr)

bcaddr - IP broadcast address (inetaddr)

OPTIONS

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

The SunOS 5.x version has no options.

ERRORS

can't get broadcast, netmask: ioctl SICGIFFLAGS failed

can't get broadcast address: ioctl SIOCGIFBRDADDR failed
can't get netmask: ioctl SIOCGIFNETMASK failed
        See ioctl (2) .
can't get broadcast, netmask: socket(2) call failed

See socket (3N) .

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.

NOTES

The way collision count is tallied depends on the Ethernet chip (Lance or Intel).

The Intel (ie) chip counts every occurrence.

The Lance (le) chip counts collision on a per-packet basis. More specifically, if a packet is successfully sent after the first retry, the collision count is one. If a packet is successfully sent after two or more retries, the chip returns a maximum count of two collisions. For example, if packeta had four retries and sometime later packetd had five retries, the cumulative collision count is four -- two for each packet -- and not the real count of nine.