Data Structures for Drivers                         gldstats(9S)



NAME
     gldstats - Generic LAN Driver statistics data structure

SYNOPSIS
     #include 


INTERFACE LEVEL
     Solaris architecture specific (Solaris DI).

DESCRIPTION
     The Generic LAN Driver (GLD) statistics  (gldstats)  struc-
     ture is used to communicate statistics and state information
     from a  GLD-based  driver  to  GLD  when  returning  from  a
     driver's  gldmgetstats()  routine  as discussed in gld(9E)
     and gld(7D). The members of this structure, filled in by the
     GLD-based  driver, are used when GLD reports the statistics.
     In the tables below, the name  of  the  statistics  variable
     reported  by GLD is noted in the comments. See gld(7D) for a
     more detailed description of the meaning of each statistic.


     Drivers can make no assumptions about  the  length  of  this
     structure, which might be different in different releases of
     Solaris and/or GLD. Structure members private  to  GLD,  not
     documented  here,  should  not  be set or read by the device
     specific driver.

STRUCTURE MEMBERS
     The following structure members are defined  for  all  media
     types:

       uint64t   gldsspeed;               /* ifspeed */
       uint32t   gldsmedia;               /* media */
       uint32t   gldsintr;                /* intr */
       uint32t   gldsnorcvbuf;            /* norcvbuf */
       uint32t   gldserrrcv;              /* ierrors */
       uint32t   gldserrxmt;              /* oerrors */
       uint32t   gldsmissed;              /* missed */
       uint32t   gldsunderflow;           /* uflo */
       uint32t   gldsoverflow;            /* oflo */




     The following structure members are defined for  media  type
     DLETHER:

       uint32t   gldsframe;                   /* alignerrors */
       uint32t   gldscrc;                     /* fcserrors */
       uint32t   gldsduplex;                  /* duplex */
       uint32t   gldsnocarrier;               /* carriererrors */



SunOS 5.11           Last change: 7 Jun 2004                    1






Data Structures for Drivers                         gldstats(9S)



       uint32t   gldscollisions;              /* collisions */
       uint32t   gldsexcoll;                  /* excollisions */
       uint32t   gldsxmtlatecoll;             /* txlatecollisions */
       uint32t   gldsdefer;                   /* deferxmts */
       uint32t   gldsdot3firstcoll;         /* firstcollisions */
       uint32t   gldsdot3multicoll;         /* multicollisions */
       uint32t   gldsdot3sqeerror;          /* sqeerrors */
       uint32t   gldsdot3macxmterror;      /* macxmterrors */
       uint32t   gldsdot3macrcverror;      /* macrcverrors */
       uint32t   gldsdot3frametoolong;     /* toolongerrors */
       uint32t   gldsshort;                   /* runterrors */




     The following structure members are defined for  media  type
     DLTPR:

       uint32t   gldsdot5lineerror          /* lineerrors */
       uint32t   gldsdot5bursterror         /* bursterrors */
       uint32t   gldsdot5signalloss         /* signallosses */
       uint32t   gldsdot5aceerror           /* aceerrors */
       uint32t   gldsdot5internalerror      /* internalerrors */
       uint32t   gldsdot5lostframeerror    /* lostframeerrors */
       uint32t   gldsdot5framecopiederror  /* framecopiederrors */
       uint32t   gldsdot5tokenerror         /* tokenerrors */
       uint32t   gldsdot5freqerror          /* freqerrors */



     Note -

       Support for the DLTPR media type is obsolete and  may  be
       removed in a future release of Solaris.


     The following structure members are defined for  media  type
     DLFDI:

       uint32t   gldsfddimacerror;          /* macerrors */
       uint32t   gldsfddimaclost;           /* maclosterrors */
       uint32t   gldsfddimactoken;          /* mactokens */
       uint32t   gldsfddimactvxexpired;    /* mactvxexpired */
       uint32t   gldsfddimaclate;           /* maclate */
       uint32t   gldsfddimacringop;        /* macringops */



     Note -

       Support for the DLFDI media type is obsolete and may  be
       removed in a future release of Solaris.



SunOS 5.11           Last change: 7 Jun 2004                    2






Data Structures for Drivers                         gldstats(9S)



     Most of the above statistics variables are counters denoting
     the  number  of  times  the  particular  event was observed.
     Exceptions are:

     gldsspeed      An  estimate  of  the  interface's   current
                     bandwidth in bits per second. For interfaces
                     that do not vary in bandwidth or  for  those
                     where  no  accurate  estimation can be made,
                     this  object  should  contain  the   nominal
                     bandwidth.


     gldsmedia      The type of media (wiring) or connector used
                     by  the  hardware. Currently supported media
                     names include GLDMAUI,  GLDMBNC,  GLDMTP,
                     GLDM10BT,      GLDM100BT,     GLDM100BTX,
                     GLDM100BT4,    GLDMRING4,     GLDMRING16,
                     GLDMFIBER,  and  GLDMPHYMI.  GLDMUNKNOWN
                     can also be specified.


     gldsduplex     Current duplex state of the interface.  Sup-
                     ported   values   are   GLDUPLEXHALF  and
                     GLDUPLEXFUL. GLDUPLEXUNKNOWN can also
                     be specified.


SEE ALSO
     gld(7D), gld(9F), gld(9E), gldmacinfo(9S)


     Writing Device Drivers























SunOS 5.11           Last change: 7 Jun 2004                    3