Kernel Functions for Drivers                pmbusycomponent(9F)



NAME
     pmbusycomponent, pmidlecomponent - control  device  com-
     ponent availability for Power Management

SYNOPSIS
     #include 
     #include 



     int pmbusycomponent(devinfot *dip, int component);


     int pmidlecomponent(devinfot *dip, int component);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI)

PARAMETERS
     dip          Pointer to the device's devinfo structure.


     component    The  number  of  the  component  to  be  power-
                  managed.


DESCRIPTION
     The pmbusycomponent() function sets component of dip to be
     busy.  Calls to pmbusycomponent() are stacked, requiring a
     corresponding number of calls to pmidlecomponent() to make
     the  component idle again. When a device is busy it will not
     be power-managed by the system.


     The  pmidlecomponent()  function  marks  component   idle,
     recording  the  time that component went idle. This function
     must be called once for each call to pmbusycomponent().  A
     component  which is idle is available to be power-managed by
     the system. The pmidlecomponent() function has  no  effect
     if  the  component  is  already  idle,  except to update the
     system's notion of when the device went idle.


     If these functions are called as a result of entry into  the
     driver's  attach(9E),  detach(9E)  or power(9E) entry point,
     these functions must be called from the  same  thread  which
     entered attach(9E), detach(9E) or power(9E).

RETURN VALUES
     The pmbusycomponent()  and  pmidlecomponent()  functions
     return:



SunOS 5.11          Last change: 21 July 2004                   1






Kernel Functions for Drivers                pmbusycomponent(9F)



     DISUCES    Successfully set the indicated component busy
                    or idle.


     DIFAILURE    Invalid component  number  component  or  the
                    device has no components.


CONTEXT
     These functions can be called from user or  kernel  context.
     These  functions  may also be called from interrupt context,
     providing they are not the first Power  Management  function
     called by the driver.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface stability          Committed                   
    


SEE ALSO
     power.conf(4), pm(7D),  attach(9E),  detach(9E),  power(9E),
     pmraisepower(9F), pm(9P), pm-components(9P)


     Writing Device Drivers






















SunOS 5.11          Last change: 21 July 2004                   2