opensolaris man page for ddi_intr_set_cap

ddi_intr_get_cap(9F)					   Kernel Functions for Drivers 				      ddi_intr_get_cap(9F)

NAME
       ddi_intr_get_cap, ddi_intr_set_cap - get or set interrupt capabilities for a given interrupt type

SYNOPSIS
       #include <sys/types.h>
       #include <sys/conf.h>
       #include <sys/ddi.h>
       #include <sys/sunddi.h>

       int ddi_intr_get_cap(ddi_intr_handle_t h, int *flagsp);

       int ddi_intr_set_cap(ddi_intr_handle_t h, int flags);

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

PARAMETERS
       ddi_intr_get_cap()

       h	 DDI interrupt handle

       flagsp	 Pointer to the capability flags returned for this handle

       ddi_intr_set_cap()

       h	DDI interrupt handle

       flags	Contains the capability flag to be set

DESCRIPTION
       The  ddi_intr_get_cap() function returns the interrupt capability flags for the interrupt handle h. Upon a successful return, the flags are
       returned in the integer pointed to by the flagsp argument.

       These flags are typically combinations of the following:

       DDI_INTR_FLAG_EDGE	 For discrete interrupts, the host supports edge type of trigger. This flag is not returned for  DDI_INTR_TYPE_MSI
				 or DDI_INTR_TYPE_MSIX interrupt types. This is a read-write (RW) flag.

       DDI_INTR_FLAG_LEVEL	 For  discrete	interrupts the host supports level, edge, or both types of triggers. This flag is not returned for
				 DDI_INTR_TYPE_MSI or DDI_INTR_TYPE_MSIX interrupt types.

       DDI_INTR_FLAG_MASKABLE	 The interrupt can be masked either by the device or by the host bridge, or optionally by  the	host.  This  is  a
				 read-only (RO) flag.

       DDI_INTR_FLAG_PENDING	 The interrupt supports an interrupt pending bit. This is a read-only (RO) flag.

       DDI_INTR_FLAG_BLOCK	 All  interrupts  of  the  given type must be block-enabled and are not individually maskable. This is a read-only
				 (RO) flag.

       The ddi_intr_set_cap() function allows a driver to specify the capability flags for the interrupt handle h.  Only  DDI_INTR_FLAG_LEVEL  and
       DDI_INTR_FLAG_EDGE  flags  can  be  set.  Some  devices	can  support  both  level  and	edge capability and either can be set by using the
       ddi_intr_set_cap() function. Setting the capability flags is device and platform dependent.

       The ddi_intr_set_cap() function can be called after interrupts are allocated and prior to adding the interrupt handler. For all other times
       it returns failure.

RETURN VALUES
       The ddi_intr_get_cap() and ddi_intr_set_cap() functions return:

       DDI_SUCCESS    On success.

       DDI_EINVAL     On encountering invalid input parameters.

       DDI_FAILURE    On any implementation specific failure.

       DDI_ENOTSUP    On device not supporting operation.

CONTEXT
       The ddi_intr_get_cap() and ddi_intr_set_cap() functions can be called from either user or kernel non-interrupt context.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+

SEE ALSO
       attributes(5),	ddi_intr_alloc(9F),   ddi_intr_block_enable(9F),   ddi_intr_get_nintrs(9F),   ddi_intr_get_pending(9F),  ddi_intr_get_sup-
       ported_types(9F), ddi_intr_set_mask(9F)

       Writing Device Drivers

NOTES
       Consumers of these interfaces 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							    20 Apr 2005 					      ddi_intr_get_cap(9F)