Manual Pages for UNIX Operating System command usage for man ddi_intr_get_pending

Kernel Functions for Drivers             ddi_intr_get_pending(9F)



NAME
     ddi_intr_get_pending - get pending bit for a given interrupt

SYNOPSIS
     #include 
     #include 
     #include 
     #include 

     int ddi_intr_get_pending(ddi_intr_handle_t h, int *pendingp);


INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI).

PARAMETERS
     h           DDI interrupt handle


     pendingp    Pointer to the pending capability  returned  for
                 this handle


DESCRIPTION
     The ddi_intr_get_pending() function returns non-zero as  the
     integer pointed to by the pendingp argument if a correspond-
     ing interrupt is pending. The corresponding interrupt handle
     h must already be allocated. The call succeeds if the device
     or host bridge supports the ability to  read  the  interrupt
     pending  bits  of  its  interrupts.  The  driver  should use
     ddi_intr_get_cap()    function     to     see     if     the
     DDI_INTR_FLAG_PENDING  flag  is  returned  to  indicate that
     interrupts support interrupt pending bits.


     If the DDI_INTR_FLAG_PENDING capability  is  not  supported,
     ddi_intr_get_pending()  returns DDI_ENOTSUP and zero in pen-
     dingp.

RETURN VALUES
     The ddi_intr_get_pending() function returns:

     DDI_SUCCESS    On success.


     DDI_EINVAL     On encountering invalid input parameters.


     DDI_FAILURE    On any implementation specific failure.






SunOS 5.11           Last change: 07Apr 2005                    1






Kernel Functions for Drivers             ddi_intr_get_pending(9F)



     DDI_ENOTSUP    On device not supporting operation.


CONTEXT
     The  ddi_intr_get_pending()  function  can  be  called  from
     either user or kernel non-interrupt context.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5),                    ddi_intr_block_enable(9F),
     ddi_intr_block_disable(9F),           ddi_intr_clr_mask(9F),
     ddi_intr_disable(9F),                   ddi_intr_enable(9F),
     ddi_intr_set_mask(9F)


     Writing Device Drivers

NOTES
     Any consumer of this interface should verify that the return
     value  is  not equal to DDI_SUCCESS. Incomplete checking for
     failure codes could result in  inconsistent  behavior  among
     platforms.





















SunOS 5.11           Last change: 07Apr 2005                    2