NAME    [Toc]    [Back]

       pthread_cond_signal_int_np  -  Wakes  one  thread  that is
       waiting on the specified condition variable  (called  from
       interrupt level only)

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_cond_signal_int_np(
               pthread_cond_t *cond );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Condition variable to be signaled.

DESCRIPTION    [Toc]    [Back]

       This  routine  wakes  one  thread waiting on the specified
       condition variable. It can only be called from a  software
       interrupt handler routine (that is, from a Tru64 UNIX signal
 handler or OpenVMS AST). Calling this routine  implies
       that  it  might be possible for a single waiting thread to
       proceed.

       The scheduling policies of the waiting  threads  determine
       which  thread  is  awakened.  For  policies SCHED_FIFO and
       SCHED_RR, a blocked thread is chosen  in  priority  order,
       using first-in/first-out (FIFO) within priorities.

       This  routine  does not cause a thread blocked on a condition
 variable to resume execution  immediately.  A  thread
       resumes execution at some time after the interrupt handler
       routine returns.

       You can call this routine regardless of whether the  associated
  mutex is locked (by some other thread). Never lock
       a mutex from an interrupt handler routine.

       Note This routine allows you to signal  a  thread  from  a
       software  interrupt handler. Do not call this routine from
       noninterrupt code. To signal a thread from the normal noninterrupt
 level, use pthread_cond_signal(3).

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value  indicating  the  type  of  error.  Possible
       return  values are as follows: Successful completion.  The
       value specified by cond is invalid.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:  pthread_cond_broadcast(3),   pthread_cond_signal(3), pthread_cond_timedwait(3), pthread_cond_wait(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                    pthread_cond_signal_int_np(3)