Manual Pages for UNIX Operating System command usage for man kstat_intr

Data Structures for Drivers                        kstat_intr(9S)



NAME
     kstat_intr - structure for interrupt kstats

SYNOPSIS
     #include 
     #include 
     #include 
     #include 


INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI)

DESCRIPTION
     Interrupt statistics are kept in the  kstat_intr  structure.
     When   kstat_create(9F)  creates  an  interrupt  kstat,  the
     ks_data field is a pointer to one of these  structures.  The
     macro  KSTAT_INTR_PTR()  is provided to retrieve this field.
     It looks like this:

       #define KSTAT_INTR_PTR(kptr)  ((kstat_intr_t *)(kptr)->ks_data)



     An interrupt is a hard interrupt (sourced from the  hardware
     device  itself),  a  soft  interrupt  (induced by the system
     through the use of some system interrupt source), a watchdog
     interrupt  (induced  by a periodic timer call), spurious (an
     interrupt entry point was entered but there was no interrupt
     to  service), or multiple service (an interrupt was detected
     and serviced just prior to returning from any of  the  other
     types).


     Drivers generally report only claimed  hard  interrupts  and
     soft  interrupts from their handlers, but measurement of the
     spurious class of interrupts  is  useful  for  auto-vectored
     devices  in order to pinpoint any interrupt latency problems
     in a particular system configuration.


     Devices that have more than one interrupt of the  same  type
     should use multiple structures.

STRUCTURE MEMBERS
       ulong_t    intrs[KSTAT_NUM_INTRS];    /* interrupt counters */



     The only member exposed to drivers is the intrs member. This
     field  is  an  array  of  counters.  The driver must use the
     appropriate counter in  the  array  based  on  the  type  of



SunOS 5.11           Last change: 4 Apr 1994                    1






Data Structures for Drivers                        kstat_intr(9S)



     interrupt condition.


     The following indexes are supported:

     KSTAT_INTR_HARD         Hard interrupt


     KSTAT_INTR_SOFT         Soft interrupt


     KSTAT_INTR_WATCHDOG     Watchdog interrupt


     KSTAT_INTR_SPURIOUS     Spurious interrupt


     KSTAT_INTR_MULTSVC      Multiple service interrupt


SEE ALSO
     kstat(9S)


     Writing Device Drivers






























SunOS 5.11           Last change: 4 Apr 1994                    2