ifstats(D4)

ifstats -- networking interface statistics structure

Synopsis

   #include <net/if.h>
   #include <sys/ddi.h>

Description

DLPI-based networking drivers record statistics relating to each interface in the ifstats structure.

Usage

Structure definitions

The ifstats structure is defined as type ifstats_t and contains the following members:

   char	*ifs_name;
   short	ifs_unit;
   short	ifs_active;
   short	ifs_mtu;
   int	ifs_ipackets;
   int	ifs_ierrors;
   int	ifs_opackets;
   int	ifs_oerrors;
   int	ifs_collisions;
   int	ifs_type;
   int	ifspeed;
   unsigned long	ifinoctets;
   unsigned long	ifinucastpkts;
   unsigned long	ifinnucastpkts;
   unsigned long	ifindiscards;
   unsigned long	ifinunkprotos;
   unsigned long	ifoutoctets;
   unsigned long	ifoutucastpkts;
   unsigned long	ifoutnucastpkts;
   unsigned long	ifoutdiscards;

ifs_name

points to a (sixteen octet maximum) character array that holds the name of this interface. If the name is less than 16 octets long it must be NULL terminated.

ifs_unit

unit number of this interface.

ifs_active

set to a non-zero value if this interface is running (up), and zero otherwise.

ifs_mtu

maximum transmission unit size.

ifs_ipackets

number of packets received.

ifs_ierrors

number of input errors encountered.

ifs_opackets

number of packets transmitted.

ifs_oerrors

number of output errors encountered.

ifs_collisions

collisions encountered for CSMA (Carrier Sense Multiple Access) interfaces.

iftype

type of interface. Valid interface types are:

IFOTHER: An interface other than one of the following types.
IFDDN_X25: A DDN X25 interface.
IFRFC877_X25: An RFC-877 compliant X25 interface.
IFETHERNET_CSMACD: An ethernet interface.
IFISO88023_CSMACD: An 802.3 interface.
IFISO88025_TOKENRING: A Token Ring interface.
IFPPP: A Point-to-Point Protocol interface.
IFLOOPBACK: A software loopback interface.
IFSLIP: A Serial Line Internet Protocol interface.

ifspeed

estimate of the current bandwidth in bits per second. If no variation in bandwidth occurs, or if no accurate estimation can be made, the normal bandwidth should be recorded.

ifinoctets

total number of octets received. This includes framing characters (if any).

ifinucastpkts

number of unicast packets delivered to higher-level protocols.

ifinnucastpkts

number of non-unicast packets delivered to higher-level protocols.

ifindiscards

number of error-free input packets that were discarded. A possible reason for discarding a packet that could otherwise be delivered to higher-level protocols might be to free up buffer space due to a low memory condition.

ifinunkprotos

number of input packets discarded due to either an unsupported protocol.

ifoutoctets

total number of octets transmitted. This includes framing characters (if any).

ifoutucastpkts

number of unicast packets received from higher-level protocols for transmission, including packets that were discarded or not sent for any reason.

ifoutnucastpkts

number of non-unicast packets received from higher-level protocols for transmission, including packets that were discarded or not sent for any reason.

ifoutdiscards

number of error-free packets received from higher-level protocols for transmission that were discarded. A possible reason for discarding a packet that could otherwise be transmitted might be to free up buffer space due to a low memory condition.

Applicable hardware

All

Version applicability

ddi: 6, 6mp, 7, 7mp, 7.1, 7.1mp

Differences betwen versions

MDI provides a more powerful statistics gathering mechanism based on media-specific structures. See ``Metrics'' in HDK Technical Reference.

References

ifstats_attach(D3), ifstats_detach(D3)

MACIOC_GETSTAT, MACIOC_SETSTAT, MACIOC_CLRSTAT

``Metrics'' in HDK Technical Reference