Kernel Functions for Drivers              ddicanreceivesig(9F)



NAME
     ddicanreceivesig - Test for ability to receive signals

SYNOPSIS
     #include 
     #include 



     booleant ddicanreceivesig(void);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     None.

DESCRIPTION
     The ddicanreceivesig() function returns a  boolean  value
     indicating  whether  the  current thread can receive signals
     sent by kill(2). If the return value is  BFALSE,  then  the
     calling   thread   cannot  receive  signals, and any call to
     qwaitsig(9F),  cvwaitsig(9F),  or    cvtimedwaitsig(9F)
     implicitly     becomes     qwait(9F),     cvwait(9F),    or
     cvtimedwait(9F), respectively. Drivers that can block inde-
     finitely  awaiting  an  event  should  use  this function to
     determine if additional means (such as timeout(9F))  may  be
     necessary to avoid creating unkillable threads.

RETURN VALUES
     BFALSE     The  calling thread is in a state in which  sig-
                 nals             cannot be  received. For  exam-
                 ple, the thread is not associated  with  a  user
                 process or is in the midst of exit(2) handling.


     BTRUE      The calling thread may receive  a  signal  while
                 blocked            on a condition variable. Note
                 that this function does not check to   determine
                 whether   signals   are  blocked  (see  sigproc-
                 mask(2)).


CONTEXT
     The ddicanreceivesig() function  may be called from user,
     kernel, or interrupt context.

SEE ALSO
     close(9E), cvwait(9F), qwait(9F)





SunOS 5.11          Last change: 15 Dec 2003                    1