ddi_intr_get_pri man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

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

NAME
       ddi_intr_get_pri,  ddi_intr_set_pri  -  get  or set priority of a given
       interrupt

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

       int ddi_intr_get_pri(ddi_intr_handle_t h, uint_t *prip);

       int ddi_intr_set_pri(ddi_intr_handle_t h, uint_t pri);

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

PARAMETERS
       ddi_intr_get_pri()

       h       DDI interrupt handle

       prip    Pointer to the priority returned for this handle

       ddi_intr_set_pri()

       h      DDI interrupt handle

       pri    Contains the priority to be set

DESCRIPTION
       The ddi_intr_get_pri() function returns the  current  priority  of  the
       interrupt  handle  h  of a given device. Upon a successful return, prip
       points	to   a	  small	   integer    value,	typically    in	   the
       DDI_INTR_PRI_MIN...DDI_INTR_PRI_MAX  range, that represents the current
       software priority setting for the interrupt. See	 <sys/ddi_intr.h>  for
       values of DDI_INTR_PRI_MIN or DDI_INTR_PRI_MAX.

       The  ddi_intr_get_pri()	function  can  be called any time, even if the
       driver adds an interrupt handler for the interrupt specification.

       The software priority returned from ddi_intr_get_pri() can be  used  in
       calls to mutex_init() and rw_init().

       The  ddi_intr_set_pri() function sets the priority pri of the interrupt
       handle h of a given device. The function validates that the argument is
       within the supported range.

       The  ddi_intr_set_pri() function can only be called prior to adding the
       interrupt handler or when an interrupt handler is unassigned. DDI_FAIL‐
       URE is returned in all other cases.

RETURN VALUES
       The ddi_intr_get_pri() and ddi_intr_set_pri() 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_pri()	and ddi_intr_set_pri() functions can be called
       from 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_enable(9F), mutex_init(9F),
       rw_init(9F)

NOTES
       The  priority  returned	from  ddi_intr_get_pri() should be typecast by
       calling the DDI_INTR_PRI macro before passing it onto mutex_init(9F).

       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.10			  04 Jun 2007		  ddi_intr_get_pri(9F)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net