ifstats(D4) ifstats(D4)
NAME
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; /* interface name */
short ifs_unit; /* unit number */
short ifs_active; /* non-zero if this interface is running */
short ifs_mtu; /* Maximum transmission unit */
int ifs_ipackets; /* packets received on interface */
int ifs_ierrors; /* input errors on interface */
int ifs_opackets; /* packets sent on interface */
int ifs_oerrors; /* output errors on interface */
int ifs_collisions; /* collisions on csma interfaces */
int ifs_type; /* interface type */
int ifspeed; /* bandwidth */
unsigned long ifinoctets; /* data octets received */
unsigned long ifinucastpkts; /* input unicast packets delivered */
unsigned long ifinnucastpkts; /* input non-unicast packets delivered */
unsigned long ifindiscards; /* input packets discarded (non-error) */
unsigned long ifinunkprotos; /* input packets discarded (bad protocol) */
unsigned long ifoutoctets; /* data octets transmitted */
unsigned long ifoutucastpkts; /* unicast packets transmitted */
unsigned long ifoutnucastpkts; /* non-unicast packets transmitted */
unsigned long ifoutdiscards; /* output packets discarded (non-error) */
The ifs_name pointer 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.
The ifs_unit field records the unit number of this interface.
The ifs_active field should be non-zero if this interface is
running (up), and zero otherwise.
Copyright 1994 Novell, Inc. Page 1
ifstats(D4) ifstats(D4)
The ifs_mtu field records the maximum transmission unit size.
The ifs_ipackets field records the number of packets received.
The ifs_ierrors field records the number of input errors
encountered.
The ifs_opackets field records the number of packets
transmitted.
The ifs_oerrors field records the number of output errors
encountered.
The ifs_collisions field records the collisions encountered
for CSMA (Carrier Sense Multiple Access) interfaces.
The iftype field records the 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.
The ifspeed field records an 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.
Copyright 1994 Novell, Inc. Page 2
ifstats(D4) ifstats(D4)
The ifinoctets field records the total number of octets
received. This includes framing characters (if any).
The ifinucastpkts field records the number of unicast packets
delivered to higher-level protocols.
The ifinnucastpkts field records the number of non-unicast
packets delivered to higher-level protocols.
The ifindiscards field records the 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.
The ifinunkprotos field records the number of input packets
discarded due to either an unsupported protocol.
The ifoutoctets field records the total number of octets
transmitted. This includes framing characters (if any).
The ifoutucastpkts field records the number of unicast packets
received from higher-level protocols for transmission,
including packets that were discarded or not sent for any
reason.
The ifoutnucastpkts field records the number of non-unicast
packets received from higher-level protocols for transmission,
including packets that were discarded or not sent for any
reason.
The ifoutdiscards field records the 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.
REFERENCES
ifstats_attach(D3), ifstats_detach(D3)
NOTICES
Portability
All processors
Copyright 1994 Novell, Inc. Page 3